Export (0) Print
Expand All

Providing Custom Connection Manager Help (.chm)

Updated: April 8, 2009

Applies To: Windows 7, Windows Server 2003, Windows Server 2003 R2, Windows Server 2003 with SP1, Windows Server 2003 with SP2, Windows Server 2008, Windows Server 2008 Foundation, Windows Server 2008 R2, Windows Server 2012, Windows Vista

Using the CMAK wizard, you can specify customize Help files that are used by the Connection Manager client with your connection profile when the user requests Help.

ImportantImportant
Help files in the form of .chm files are only included with profiles that are created by using the Windows 7 or Windows Vista option, and that are installed on computers running one of those versions of Windows. Help files created by using the Windows Server 2003, Windows XP, or Windows 2000 option and that are installed on one of those versions of Windows use .hlp files for Help. To customize an .hlp file for those earlier versions of Windows, see Providing Custom Connection Manager Help (.hlp). If a profile created for the older versions of Windows (with an .hlp file included) is installed on Windows 7 or Windows Vista, then the default .chm file included with Windows is displayed.

You can create a customized .chm Help file by using the HTML Help Workshop available at HTML Help Workshop and Documentation (http://go.microsoft.com/fwlink/?linkid=79110).

Sample source files that can be easily customized by using the HTML Help Workshop to create a custom .chm file are available at Connection Manager Administration Kit – Sample Source Files for Customized Help (http://go.microsoft.com/fwlink/?linkid=108180).

If you want to include custom Windows Help, you must prepare your files before you run the CMAK wizard. Download the sample source file from the Microsoft Web site, and then run the file to decompress the source files into a folder structure called ConnMgrSampleSource.

Examine the files in the folder HTML. We recommend that you open them in a plain text editor such as Notepad to ensure that the formatting is not corrupted. The files each have a file name that must be kept intact. The Connection Manager client program knows that for each of the following user interface elements to launch the Help topic shown in the following table.

 

User interface page Help topic file name

Default (top) page

html\b854775b-accb-4164-b87f-4a720000b211.htm

Logon Dialog Box

html\a9bd50f1-5416-4f04-8d72-742f749f2250.htm

Connection Properties – General Tab

html/f1bc39ab-adba-441c-8f87-74e758fc7c2a.htm

Connection Properties – Internet Logon Tab

html/517c1028-bc82-44e8-a21e-470c13f9e7c6.htm

Connection Properties – VPN Tab

html/940f744a-5b41-4b3b-a9b4-59eada5d93d1.htm

Connection Properties – Options Tab

html/095acd5b-3169-411f-974d-b1d2d653f3cc.htm

Connection Properties – Sharing Tab

bbf3b918-dca6-4809-837a-a0300f43cf74.htm

ImportantImportant
Any page in your Help file that does not have one of the file names shown in the previous table cannot be invoked by the user by pressing F1 from the user interface. The pages do show up in the Help table of contents, however, so you can include additional pages and link to them from the pages referenced in the table.

The pages must be stored in a folder named html that is under the folder containing the .hhc and .hhp files that define the Help project in HTML Help Workshop.

Place graphics that you want to include in the local folder, and refer to them in the .htm source files by using syntax similar to ../local/artfilename.gif.

When specifying your custom Help file in the CMAK wizard, browse to it. If you type the name, no validation is done on the file name (including the file name extension).

Be sure to test the Help files on all target platforms before delivering your service profile to your users. Test Help by starting Connection Manager and pressing F1 on each user interface page. Testing the file by opening it outside of Connection Manager does not verify the correct connection of each topic to the correct user interface page.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft