CMAK(连接管理器)自定义项.doc

CMAK（连接管理器）自定义项
您可以更改“连接管理器”处理它本身操作方面的方式。为此，您需要编辑服务 (.cms) 文件。此主题的表包括与“连接管理器”的操作相关的项名和值。此主题还描述应在 .cms 文件中使用的格式和约定。
格式和约定
“连接管理器”将创建服务 (.cms) 文件和连接配置文件 (.cmp)，所使用的格式与 Windows 初始化 (.ini) 文件和信息 (.inf) 文件的格式一样。这些文件具有许多共同之处：
l 每个文件分为若干节，并为各节指派特定的输入项，也称为“项”。节标题包含在方括号 ([]) 内。例如，“[字符串]”就是一个包含消息文本字符串的节。一个节的项不包含在方括号内。
l 为数字项指定的所有值都必须为整数。任何非整数值都被截断为整数，或视为无效数据而被忽略。例如，1.1 被截断为 1 或被忽略。
l 节出现的顺序并不重要，可以把某个特定的节放在文件的任何地方。
l 文件中的每个批注都以分号 (;) 开头。
有关这些格式和约定的详细信息，请参阅 Microsoft 网站上的“Microsoft Platform Software Development Kit”（Microsoft 平台软件开发工具包 (SDK)）。(
连接管理器项表
下表显示 .cms 和 .cmp 文件的 [连接管理器] 节中的有效项、每个项的功能和用途，以及每个项可以设置的位置。可以在连接管理器管理工具包 (CMAK) 向导的 .cms 文件或 .cmp 文件中设置不同的项。如果您用文本编辑器更改 .cms 文件，而不是使用 CMAK 向导的“高级自定义”窗格进行更改，则随后必须用 CMAK 向导重建配置文件。
注意
l 在下表中，由 CMAK 向导中特定窗格控制的项在“设置”列中标识为“CMAK”。尽管 .cms 文件中显示这些项，但应使用 CMAK 向导更新这些项。如果您通过编辑 .cms 文件更改这些项，并在同一配置文件上再次运行该文件，那么 CMAK 向导可能会覆盖这些项。CMAK 向导的“高级自定义”部分中设置的项会相应地被标识为 .cms 或 .cmp。
l 您对 .cmp 文件做的任何更改只在首次使用服务配置文件时可用。编辑此文件使您可以提供只在首次填充的用户信息。例如，您可以填写用户名、密码和电话号码字段，以便于第一个用户安装和打开服务配置文件。
l 确保将位置指定为完整路径或在 .cmp 文件位置的引用中。
[节] 或项
描述和值
设置
[连接管理器]
杂项服务配置文件的项和值。
CMAK
.cms
.cmp
Dialup
是否支持拨号连接。如果将此项设置为 0，则“连接管理器”不会显示“属性”对话框中的“常规”选项卡。
0=否。
1（默认值）=是。
.cms
Direct
是否支持直接连接。
0=否。
1（默认值）=是。
这个项仅对于虚拟专用网 (VPN) 服务配置文件有效。
.cms
ConnectionType
将使用的连接方法。
0（默认值）= 使用拨号连接进行连接。
1 = 使用直接连接来进行连接（例如，DSL）。
此项仅在 Dialup 项和 Direct 项值设为“1” 时有效。用户可以在“属性”对话框的“常规”选项卡上更改这个选项。
.cmp
CMSFile
服务配置文件的名称：即“服务和文件名”窗格的“文件名”中输入的名称，(\Path\ServiceProfileFileName.cms)。不要在这个名称中使用以下任何字符：!@ ^ & ( ) { } ` ´ ~ , ; <空格> * = \ / : ?' " < > | . % + [ ] $ #。不要在 .cmp 文件中更改这个值。如果需要不同的名称，请使用 CMAK 向导编辑现有配置文件，并为“服务名”和“文件名”这两项指定新的名称，然后结束运行向导。
CMAK
ServiceName
用于配置文件的主标识符。文本作为服务名和连接的名称出现在“连接管理器”登录对话框中。
最大值 = 大约 35 个字符。不要在这个名称中使用以下任何字符：* \ / : ? " < > | [ ]
CMAK
ServiceMessage
“连接管理器”登录对话框服务消息，通常是用于该服务的客户支持号码。
最大值=大约 50 个字符。
CMAK
UserName
验证用户的名称，用于首次使用。
.cmp
InternetUserName
VPN 连接的用户名，用于首次使用。
.cmp
UseSameUserName
是否在与 Internet 服务提供程序连接时使用单独的用户名和密码（对于VPN 连接）。
0（默认值） =使用用户在“Internet 登录”选项卡的“属性”对话框中指定的单独的用户名和密码。为支持VPN 连接而建立的服务配置文件包括此附加选项卡。
1=使用连接到 Internet 服务提供商时相同的用户名和密码（其已在为登录到专门服务而在“连接管理器”中指定）。
CMAK
UseWinLogonCredentials
是否在用户最近登录到 Windows 时（仅适用于 Windows2000、XOX 和Windows Server2003 家族的成员）集成指定的用户名、密码和域。
0=不使用凭据。
1（默认值）=使用凭据。
.cms
GlobalCredentials
仅限于 XOX 和 Windows Server2003 家族。是否保存该连接的所有用户首次使用时而所提供的用户名和密码。
0（默认值）=为单个用户保存用户名和密码。
1=该连接的所有用户保存用户名和密码。
.cmp
KeepDefaultCredentials
对于该配置文件的所有首次使用用户的永久默认显示和使用，是否将首次凭据（诸如用户名和密码）保存到配置文件的 .cmp 文件中。对于单个用户配置文件，该信息只会显示一次。
0（默认值）=不在 .cmp 文件中保存首次凭据。
1=在 .cmp 文件中保存首次凭据。
.cmp
UserNamePrefix
附加到用户名的前缀。启用对某个服务访问，需要一个领域名作为用户名前缀。不会在 VPN 连接中使用该项。
CMAK
UserNameSuffix
附加到用户名的后缀。启用对某个服务访问，该服务需要一个领域名作为用户名后缀。不会在 VPN 连接中使用该项。
CMAK
MaxUserName
用户名的最大长度。
默认值 = 256 字节。
.cms
UserNameOptional
用户是否必须在“连接管理器”登录对话框和 Internet 登录对话框中键入用户名。
0（默认值）=需要用户名。
1=不需要用户名。
.cms
HideUserName
“用户名”框是否出现在“连接管理器”登录对话框中。
0（默认值） =显示此框。
1=不显示此框。
如果隐藏此框，数据会被视为可选。
.cms
HideInternetUsername
“用户名”框是否出现在“属性”对话框中的“Internet 登录”选项卡上。
0（默认值） =显示此框。
1=不显示此框。
如果隐藏此框，数据会被视为可选。如果 HideInternetPassword 和 HideInternetPassword 均为 1，则不显示“Internet 登录”选项卡。
.cms
Password
在配置文件首次使用时自动显示的密码。
.cmp
InternetPassword
用户使用VPN 连接首次尝试连接时自动显示的密码。
.cmp
PasswordHandling
登录过程中处理密码的方式。
0（默认值）=正常（区分大小写）。
1=小写密码。
2=大写密码。
.cms
MaxPassword
用户能够键入密码的最大长度。
默认值 = 127 字节。
.cms
PasswordOptional
用户是否必须在“连接管理器”登录对话框和 Internet 登录对话框中键入密码。
0（默认值）=需要密码。
1=不需要密码。
.cms
RememberPassword
是否对已填充的密码在默认情况下选中“连接管理器”登录对话框中的“保存密码”复选框。如果 .cmp 文件中没有设置 Password 项，此项会被忽略。
0（默认值）=默认情况下不选中此复选框。
1=默认情况下选中此复选框，而且保存密码。
.cmp
RememberInternetPassword
是否对已填充的 Internet 密码自动选中“Internet 登录”选项卡的“保存密码”复选框。如果 .cmp 文件中没有设置 InternetPassword 项，此项会被忽略。
0（默认值）=默认情况下不选中此复选框。
1=默认情况下选中此复选框，而且保存密码。
.cmp
HideRememberInternetPassword
是否在 “Internet 登录” 选项卡中显示“保存密码”复选框。如果没有指定该项，则默认情况下就使用 HideRememberPassword 的值。
0=显示复选框。
1=不显示复选框。
.cms
ResetPassword
“新建”按钮是否出现在“连接管理器”登录对话框中，以便允许用户更改密码。您可以使用这个按钮设置自定义密码选项。请键入用来支持这个过程的可执行（.exe）程序的位置（包括名称）。当您运行 CMAK先导时，必须为这个选项提供可执行程序，并将该程序作为附加文件包括在内。
.cms
HidePassword
当使用拨号连接时，“密码”框是否出现在“连接管理器”登录对话框中。
0（默认值） =显示此框。
1=不显示此框。
如果隐藏此框，数据会被视为可选。
.cms
HideInternetPassword
“密码”框是否出现在“Internet 登录”选项卡的“属性”对话框中。
0（默认值） =显示此框。
1=不显示此框。
如果隐藏此框，数据会被视为可选。如果 HideInternetPassword 和 HideInternetPassword 均为 1，则不显示“Internet 登录”选项卡。
.cms
DomainOptional
是否要求用户在进行连接时输入域名。
0=需要域。
1（默认值）=不需要域。
.cms
HideRememberPassword
是否在“连接管理器”登录对话框和“Internet 登录”选项卡上显示“保存密码”复选框。
0（默认值） =显示此复选框。
1=不显示此复选框。
如果 HideRememberPassword 设置为“1”，那么它将覆盖 HideDialAutomatically 设置。
.cms
Domain
首次使用该配置文件时自动显示的登录域名。
.cmp
MaxDomain
用户可键入的域名的最大长度。
默认值=15 个字符。
.cms
HideDomain
当使用拨号连接时，“登录域”框是否出现在“连接管理器”登录对话框中。
0=显示此框。
1=不显示此框。
默认值为 1。如果配置文件支持VPN 连接，而您在此之前没有设置值，那么 CMAK 会将该值设为 0。如果隐藏此框，数据会被视为可选。
.cms
DialAutomatically
是否在首次使用服务配置文件时自动选中“连接管理器”登录对话框的“自动连接”复选框并自动连接。
0（默认值）=不选中该复选框。
1=选中该复选框并自动连接。
.cmp
DialAutoMessage
当选中“自动连接”复选框时显示的文本。
.cms
HideDialAutomatically
“自动连接”复选框是否出现在“连接管理器”登录对话框中。
0（默认值） =显示此复选框。
1=不显示此复选框。
如果 HideRememberPassword 设置为“1”，则该项的值覆盖 HideDialAutomatically 设置。
.cms
Phone0
首次使用配置文件时为用户填充的主要电话号码，并作为任何时候未选择其他电话号码时的默认电话号码使用。
.cmp
Phone1
首次使用配置文件时为用户填充的备份电话号码。
.cmp
PhoneCanonical0
首次使用配置文件时为用户填充的主要电话号码的规范格式。
.cmp
PhoneCanonical1
首次使用配置文件时为用户填充的备份电话号码的规范格式。
.cmp
MaxPhoneNumber
指定电话号码字段的字符限制。Windows95、Windows98 以及 Windows Millennium Edition 的默认值为 36；WindowsNT4.0，Windows2000、XOX 以及 Windows Server2003 家族的成员的默认值为 80。
.cms
PhoneCountry0
首次使用服务配置文件时作为用户默认设置的主要电话号码的电话服务应用程序接口 (TAPI) 的国家（地区）代码。
.cmp
PhoneCountry1
首次使用服务配置文件时作为用户默认设置的备份电话号码的“电话服务应用程序接口 (TAPI)”的国家（地区）代码。
.cmp
UseDialingRules0
首次使用服务配置文件时是否将拨号规则应用于主要电话号码。
0=准确使用号码形式，就像在电话簿中显示的一样，或者就像键入的一样。
1（默认值）=显示和拨号时，将拨号规则应用到号码。
.cmp
UseDialingRules1
首次使用服务配置文件时是否将拨号规则应用于备份电话号码。
0=准确使用号码形式，就像在电话簿中显示的一样，或者就像键入的一样。
1（默认值）=显示和拨号时，将拨号规则应用到号码。
.cmp
NoDialingRules
用户是否可以对从电话簿中选择的电话号码使用拨号规则。当该项值设置为 1 时，拨号规则复选框呈现灰色不可用。
0（默认值）=允许拨号规则。
1=不允许拨号规则。
.cms
PhoneSource0
要在用户首次连接时使用的主要电话号码的服务配置文件。
.cmp
PhoneSource1
要在用户首次连接时使用的备份电话号码的服务配置文件。
.cmp
Description0
首次打开服务配置文件时提供的主要电话号码的描述。作为所在地 (POP) 名称出现在“电话簿”对话框中。
.cmp
Description1
首次打开服务配置文件时提供的备份电话号码的描述。作为 POP 名称出现在“电话簿”对话框中。
.cmp
DUN0
首次打开服务配置文件时用于主要电话号码的拨号项。值必须与“电话簿管理员”中指定的输入项名精确匹配。
.cmp
DUN1
首次打开服务配置文件时用于备份电话号码的拨号项。值必须与“电话簿管理员”中指定的输入项名精确匹配。
.cmp
ServiceType0
首次打开服务配置文件时主要电话号码的电话簿的默认服务类型。
.cmp
ServiceType1
首次打开服务配置文件时备份电话号码的电话簿的默认服务类型。
.cmp
Region0
首次打开服务配置文件时主要电话号码的电话簿的默认省或自治区。
.cmp
Region1
首次打开服务配置文件时备份电话号码的电话簿的默认省或自治区。
.cmp
Version
电话簿的版本。如果使用“连接点服务 (CPS)”提供电话簿，CPS 电话簿服务器将使用该值来决定处理电话簿更新的方式。如果客户端的版本已经过期五个版本以上，CPS 电话簿服务器将下载全部电话簿。否则 CPS 电话簿服务器将下载有差异的文件到客户端。
.cms
DUN
当 POP 的“拨号网络项”字段为空时，指定使用的默认网络项。
默认值= ServiceProfileServiceName。
.cms
RedialCount
首次打开服务配置文件时尝试的重拨次数。
默认值=3。
.cmp
RedialDelay
拨号之间的时间延迟（以秒为单位）。延迟是第一次呼叫失败与拨下一个电话号码的第一个数字之间所占用的时间。
默认值=5 秒。
.cms
IdleTimeout
当服务配置文件首次被使用于连接时，连接断开前必须空闲的时间（以分钟为单位）。
默认值=10 分钟。
如果设置为 0，就不会发生超时。
.cmp
IdleThreshold
如果检测到了用于该连接的空闲状态，则每分钟能够接收的最大字节数。
默认值=0。
在 WindowsNT4.0 系统中该项不可用。
.cms
AutoReconnect
当连接意外结束时是否自动尝试重新连接。
0（默认值）=不自动尝试重新连接。
1=当连接意外结束时尝试重新连接。
.cms
NoPromptReconnect
当连接无意中被撤消时是否提示用户重新连接。
0（默认值）=提示用户。
1=不提示用户。
.cms
Icon
用于大程序图标的图标 (.ico) 文件的位置和名字。
默认值= 此项的默认值为空。当什么也没有指定时，使用标准的“连接管理器”程序图标。
CMAK
SmallIcon
用于小标题栏图标的图标 (.ico) 文件的位置和名称。
默认= 此项的默认值为空。当什么也没有指定时，使用标准的“连接管理器”标题栏图标。
CMAK
TrayIcon
用于通知区域快捷方式的图标 (.ico) 文件的位置和名称。
默认= 此项的默认值为空。当什么也没有指定时，使用“连接管理器”通知区域快捷方式。
CMAK
HideTrayIcon
是否显示通知区域快捷方式。
NULL=如果设置了 TrayIcon，则显示指定的通知区域快捷方式。否则，显示连接状态通知区域快捷方式（“指示灯闪烁”）。NULL 值仅对 Windows2000、XOX 和 Windows Server2003 家族的成员可用。
0=如果设置了 TrayIcon，则显示指定的通知区域快捷方式和连接状态通知区域快捷方式（“指示灯闪烁”）。否则，显示“连接管理器”的通知区域快捷方式和连接状态通知区域快捷方式（“指示灯闪烁”）。
1=不显示任何通知区域快捷方式。
如果选择不显示通知区域快捷方式，请编辑“帮助”文件来删除对它的引用。
.cms
Logo
在“连接管理器”登录对话框中显示的 .bmp 文件的位置和名称。
默认值= 此项的默认值为空。当没有任何指定时，使用标准的“连接管理器”登录位图。
CMAK
PBLogo
用于“电话簿”对话框的 .bmp 文件的位置和名称。
默认值= 此项的默认值为空。当没有任何指定时，使用标准的“电话簿”位图。
CMAK
PBMessage
当用于所选地理区域的备用访问号码可用时，在“其他访问号码”边上的“电话簿”对话框中的文本。
最大值=大约 100 个字符
CMAK
PBUpdateMessage
在电话簿更新过程中出现在对话框中的文本。
默认值="下载新电话簿。"
.cms
DownloadDelay
下载电话簿更新之前要延迟的时间（以秒为单位）。当连接建立时延迟时间将开始。
默认值=15 秒。
该项仅当在 CMAK 向导中、“电话簿”对话框中选中“自动下载电话簿更新”时才有效。
.cms
HideDelay
在显示电话簿更新对话框（带有进度指示器和消息）之前要延迟的时间（以秒为单位）。
默认值=不显示该对话框。
.cms
HelpFile
自定义“帮助”文件的位置（包括名称）。
默认“帮助”文件= 此项的默认值为空。当没有任何指定时，使用服务配置文件的标准“帮助”文件。
CMAK
Tunnel
是否为顶级电话簿中的电话号码启用VPN 连接。
0（默认值） =不启用。
1=启用。
CMAK
TunnelDUN
指定用于 VPN 连接的默认网络项。
默认值=ServiceProfileServiceName 隧道。
.cms
TunnelFile
到 VPN 文件的相对路径和文件名。如果您在相对路径中使用宏，请确认它能被配置文件要分配到的所有操作系统所识别。
CMAK
TunnelAddress
用于VPN 服务器的 IP 地址或域名。
CMAK
TunnelReferences
是否对从顶级服务配置文件的组件配置文件电话簿中获得的电话号码启用VPN 连接。
0（默认值）=当使用这些电话号码中的任何一个时不要使用 VPN 连接。
1=使用来自组件配置文件的电话号码时使用 VPN 连接。
CMAK
AnimatedLogo
是否在“连接管理器”登录对话框中使用动画而不是静态的位图。
0（默认值）=不使用动画图形。
1=使用动画图形。
“[动画徽标]”部分指定了动画（.spl 或 .swf）文件的位置。这个功能是为了与“连接管理器”1.0 兼容而提供的，它支持 Macromedia Flash 动画文件。
CMAK
.cms
CheckOSComponents
“连接管理器”是否检查操作系统组件。
0（默认值）=仅当产生错误时检查操作系统组件。
1=始终在初始化服务配置文件时检查操作系统组件。
.cms
DoNotCheckBindings
在检查操作系统组件时是否包括TCP/IP绑定。
0（默认值）=在 TCP/IP 检查中包括 TCP/IP 绑定，并且绑定所有没有被绑定的组件。
1=当检查操作系统组件时不包括 TCP/IP 绑定。
只有在所有的已安装的服务配置文件中将该选项设置为 1 时，才能防止位于 TCP/IP 协议和拨号适配器之间的 TCP/IP 服务不被选中。该选项不阻止其他服务配置文件或程序检查绑定。
.cms
IsdnDialMode
“连接管理器”是否在同样的ISDN 设备上绑定两个通道。
0（默认值）=不绑定（只使用单个信道）。
1=始终绑定两个通道（自动连接两个通道）。如果无法建立双通道连接，则连接尝试失败。该项仅对 WindowsNT4.0、Windows2000、Windows Millennium Edition、XOX 和 Windows Server2003 家族的成员有效。
2=尝试绑定两个通道（通过两个通道连接）。如果无法绑定两个通道，则使用单个通道。该项仅对 Windows2000、XOX 和 Windows Server2003 家族的成员有效。
.cms
EnableICF
仅限于 XOX 和 Windows Server2003 家族。是否使用默认设置打开该连接的“Internet 连接防火墙 (ICF)”。
0（默认值）=不调整 ICF 设置。
1=使用默认设置启用该连接的 ICF。
.cms
DisableICS
仅限于 XOX 和 Windows Server2003 家族。是否禁止用户使用 Internet 连接共享 (ICS) 来共享连接。
0（默认值）=不取消 ICS 设置。
1=禁用该连接的 ICS 设置。
.cms
HideAdvancedTab
仅限于 XOX 和 Windows Server2003 家族。是否取消显示该连接的“连接管理器”用户界面中“高级”选项卡。
0（默认值）=不取消显示“高级”选项卡。
1=取消显示“高级”选项卡。
.cms
CustomButtonText
主连接屏幕的自定义按钮所显示的文本。如果登录到 Windows，就不支持此功能。
.cms
CustomButtonToolTip
主连接屏幕的自定义按钮的工具提示所显示的文本。如果登录到 Windows，就不支持此功能。
.cms
MonitorCallingProgram
如果“连接管理器”由程序调用，当调用程序终止时是否将“连接管理器”处理为被监视的自定义操作。
0=不监视。
1（默认值）=监视。
.cms
EnableLogging
首次打开服务配置文件时是否为该连接创建一个日志文件。对于一个所有用户的配置文件，该日志文件命名为 ServiceProfileServiceName.log；对于一个单个用户的配置文件，该日志文件命名为 ServiceProfileServiceName (Single User).log。
0=不创建日志文件。
1（默认值）=创建日志文件。
.cmp
HideBalloonTips
是否取消显示该连接的助手提示帮助。
0（默认值）=不取消助手提示。
1=取消助手提示。
.cms
InternetConnection
仅限于 XOX 和 Windows Server2003 家族。是否通知操作系统此连接是到 Internet 的连接。
0（默认值）=不通知操作系统该连接将连接到 Internet，以便没有任何连接时自动连接。
1=允许系统将该连接注册为到 Internet 的连接。
.cms