HotSpot 云解决方案提供商HotSpot CSP

HotSpot 配置服务提供程序用于在设备上配置和启用 Internet 共享,设备可配置为通过 Wi-Fi 与最多八台客户端设备或计算机共享其手机网络连接。The HotSpot configuration service provider is used to configure and enable Internet sharing on the device, in which the device can be configured to share its cellular connection over Wi-Fi with up to eight client devices or computers.

注意 热点 CSP 仅在 Windows 10 移动版中受支持。Note HotSpot CSP is only supported in Windows 10 Mobile.

注意 此配置服务提供程序要求从网络配置应用程序访问 ID_CAP_CSP_FOUNDATION 功能。Note This configuration service provider requires the ID_CAP_CSP_FOUNDATION capability to be accessed from a network configuration application.

下图以树格式显示 OMA 客户端预配所使用的 HotSpot 配置服务提供程序管理对象。The following diagram shows the HotSpot configuration service provider management object in tree format as used by OMA Client Provisioning. 此配置服务提供商不支持 OMA DM 协议。The OMA DM protocol is not supported by this configuration service provider.

热点云解决方案提供商 (cp)

已启用 必填。Enabled Required. 指定是否在设备上启用 Internet 共享。Specifies whether to enable Internet sharing on the device. 默认值为 false。The default is false.

如果最初设置为 false,则功能将关闭,并且 Internet 共享屏幕将从"设置"中删除,以便用户无法访问它。If this is initially set to false, the feature is turned off and the Internet sharing screen is removed from Settings so that the user cannot access it. 无法更改配置或连接共享状态。Configuration changes or connection sharing state changes will not be possible.

当设置为 true 时,Internet 共享屏幕将添加到"设置"中,尽管默认情况下会关闭共享,直到用户将其打开。When this is set to true, the Internet sharing screen is added to Settings, though sharing is turned off by default until the user turns it on.

此设置可进行实时设置,但如果首次启用此设置时已打开"设置",可能需要重新启动。This setting can be provisioned over the air, but it may require a reboot if Settings was open when this was enabled for the first time.

DedicatedConnections 可选。DedicatedConnections Optional. 指定 Internet 共享将用作公共连接的连接管理器手机网络连接的分号分隔列表。Specifies the semicolon separated list of Connection Manager cellular connections that Internet sharing will use as the public connections.

默认情况下,任何可用的连接将用作公共连接。By default, any available connection will be used as a public connection. 但是,此节点允许移动运营商指定一个或多个连接名称,以用作公共连接。However, this node allows a mobile operator to specify one or more connection names to use as public connections.

指定的连接将按策略映射到 Internet 共享服务。Specified connections will be mapped, by policy, to the Internet sharing service. 所有尝试对 Internet 共享服务枚举连接管理器连接的操作将仅返回映射的连接。All attempts to enumerate Connection Manager connections for the Internet sharing service will return only the mapped connections.

注意 映射策略还将包括在 TetheringNAIConnection 值中指定的连接。Note The mapping policy will also include the connection specified in the TetheringNAIConnection value as well.

如果指定的连接不存在,将不会启动 Internet 共享,因为它将没有任何可用的手机网络连接进行共享If the specified connections do not exist, Internet sharing will not start because it will not have any cellular connections available to share

如果 Internet 共享服务已进入共享状态,在停止并重新启动共享之前,设置此节点不会生效。If the Internet sharing service is already in a sharing state, setting this node will not take effect until sharing is stopped and restarted.

TetheringNAIConnection 可选。TetheringNAIConnection Optional. 指定 Internet 共享将用作公用连接的 CDMA TetheringNAI 连接管理器手机网络连接。Specifies the CDMA TetheringNAI Connection Manager cellular connection that Internet sharing will use as a public connection.

如果 CDMA 移动运营商要求在 Internet 共享期间使用 Tethering NAI,则必须使用 CM_CellularEntries 配置服务提供商设置 TetheringNAI 连接,然后在此节点中指定已设置的连接。If a CDMA mobile operator requires using a Tethering NAI during Internet sharing, they must use the CM_CellularEntries configuration service provider to provision a TetheringNAI connection and then specify the provisioned connection in this node.

指定的连接将按策略映射到 Internet 共享服务。Specified connections will be mapped, by policy, to the Internet sharing service. 所有尝试对 Internet 共享服务枚举连接管理器连接的操作将仅返回映射的连接。All attempts to enumerate Connection Manager connections for the Internet sharing service will return only the mapped connections.

注意 映射策略还将包括在 DedicatedConnections 中指定的连接。Note The mapping policy will also include the connections specified in the DedicatedConnections as well.

如果指定的连接不存在,将不会启动 Internet 共享,因为它将没有任何可用的手机网络连接进行共享If the specified connections do not exist, Internet sharing will not start because it will not have any cellular connections available to share

如果 Internet 共享服务已进入共享状态,在停止并重新启动共享之前,设置此节点不会生效。If the Internet sharing service is already in a sharing state, setting this node will not take effect until sharing is stopped and restarted.

MaxUsers 可选。MaxUsers Optional. 指定在共享状态中可同时连接到设备的最大用户数。Specifies the maximum number of simultaneous users that can be connected to a device while in a sharing state. 该值必须介于 1 和 8 之间(包含这两个值)。The value must be between 1 and 8 inclusive. 默认值为 5。The default value is 5.

如果 Internet 共享服务已进入共享状态,在停止并重新启动共享之前,设置此节点不会生效。If the Internet sharing service is already in a sharing state, setting this node will not take effect until sharing is stopped and restarted.

MaxBluetoothUsers 可选。MaxBluetoothUsers Optional. 指定用户通过 Bluetooth 共享时可连接到设备的最大并发Bluetooth。Specifies the maximum number of simultaneous Bluetooth users that can be connected to a device while sharing over Bluetooth. 该值必须介于 1 和 7 之间(包含这两个值)。The value must be between 1 and 7 inclusive. 默认值为 7。The default value is 7.

MOHelpNumber 可选。MOHelpNumber Optional. 移动运营商指定的设备编号,在 Internet 共享服务无法启动时向用户显示。A mobile operator–specified device number that is displayed to the user when the Internet sharing service fails to start. 用户界面会显示一则消息,通知用户他们可以拨打指定的号码寻求帮助。The user interface displays a message informing the user that they can call the specified number for help.

MOInfoLink 可选。MOInfoLink Optional. 移动运营商指定的 HTTP 链接,在禁用 Internet 共享或设备无权共享时向用户显示。A mobile operator–specified HTTP link that is displayed to the user when Internet sharing is disabled or the device is not entitled. 用户界面将显示一则消息,通知用户他们可以访问指定的链接,以了解有关如何启用该功能的详细信息。The user interface displays a message informing the user that they can visit the specified link for more information about how to enable the feature.

MOAppLink 可选。MOAppLink Optional. 指向移动运营商提供的预安装应用程序的 Windows 设备应用程序链接,可帮助用户在未设置 Internet 共享或权利失败时订阅移动运营商的 Internet 共享服务。A Windows device application link that points to a preinstalled application, provided by the mobile operator, that will help a user to subscribe to the mobile operator’s Internet sharing service when Internet sharing is not provisioned or entitlement fails. 链接的常规格式为 app://MOappThe general format for the link is app://MOapp.

MOHelpMessage 可选。MOHelpMessage Optional. 对移动运营商提供的本地化字符串的引用,当由于权利失败而未启用 Internet 共享时显示该字符串。Reference to a localized string, provided by the mobile operator, that is displayed when Internet sharing is not enabled due to entitlement failure. 节点采用与语言无关的注册表值字符串,其格式如下:The node takes a language-neutral registry value string, which has the following form:

@<path_to_res_dll>,-<str_id>

其中 <path_to_res_dll> 是包含字符串的资源 dll 的路径, <str_id> 是字符串标识符。Where <path_to_res_dll> is the path to the resource dll that contains the string and <str_id> is the string identifier. 有关中性语言字符串资源注册表值的信息,请参阅在 MSDN 上使用 注册表字符串 重定向。For more information on language-neutral string resource registry values, see Using Registry String Redirection on MSDN.

注意 MOAppLink 是使用 MOHelpMessage 设置必需的。Note MOAppLink is required to use the MOHelpMessage setting.

EntitlementRequired 可选。EntitlementRequired Optional. 指定设备是否需要权利检查,以确定是否应该启用 Internet 共享。Specifies whether the device requires an entitlement check to determine if Internet sharing should be enabled. 此节点设置为布尔值。This node is set to a Boolean value. 默认值为 TrueThe default value is True.

默认情况下,每次尝试启用 Internet 共享时,Internet 共享服务都会检查授权。By default the Internet sharing service will check entitlement every time an attempt is made to enable Internet sharing. 对于运营商解锁的设备,Internet 共享应设置为False。Internet sharing should be set to False for carrier-unlocked devices.

EntitlementDll 如果 设置为 EntitlementRequired true,则必需。EntitlementDll Required if EntitlementRequired is set to true. 用于进行权利检查的权利 DLL 的路径,用于验证设备是否有权在移动运营商网络上使用 Internet 共享服务。The path to the entitlement DLL used to make entitlement checks that verify that the device is entitled to use the Internet sharing service on a mobile operator’s network. 该值是一个字符串,表示权利 DLL 的有效文件系统路径。The value is a string that represents a valid file system path to the entitlement DLL. 默认情况下,如果此设置缺失或为空,Internet 共享服务将不能通过权利检查。By default, the Internet sharing service fails entitlement checks if this setting is missing or empty. 有关详细信息,请参阅本主题稍后介绍的创建权利 DLL。For more information, see Creating an Entitlement DLL later in this topic.

EntitlementInterval 可选。EntitlementInterval Optional. 权利检查之间的时间间隔(以秒为单位)。The time interval, in seconds, between entitlement checks. 默认值为 86,400 秒, (24 小时) 。The default value is 86,400 seconds (24 hours).

如果定期权利检查失败,将自动禁用 Internet 共享。If a periodic entitlement check fails, Internet sharing is automatically disabled.

PeerlessTimeout 可选。PeerlessTimeout Optional. 如果不再有任何活动客户端,则 Internet 共享应自动关闭的退出时段(分钟)。The time-out period, in minutes, after which Internet sharing should automatically turn off if there are no longer any active clients. 此节点可以设置为 1 到 120 之间(包含 1 和 120)之间的任意值。This node can be set to any value between 1 and 120 inclusive. 不支持值 0。A value of 0 is not supported. 默认值为 5 分钟。The default value is 5 minutes.

在更改此节点生效之前,可能需要重新启动。A reboot may be required before changes to this node take effect.

PublicConnectionTimeout 可选。PublicConnectionTimeout Optional. 以分钟表示的退出值,如果手机网络连接不可用,Internet 共享将自动关闭。The time-out value, in minutes, after which Internet sharing is automatically turned off if a cellular connection is not available. 此节点可以设置为 1 到 60 之间(包含 1 和 60)之间的任意值。This node can be set to any value between 1 and 60 inclusive. 默认值为 20 分钟。The default value is 20 minutes. 需要退出,因此不支持值 0。A time-out is required, so a value of 0 is not supported.

对此节点的更改需要重新启动。Changes to this node require a reboot.

MinWifiKeyLengthMinWifiKeyLength

重要 Windows Phone 8.1 不再支持此面值。Important This parm is no longer supported for Windows Phone 8.1. 强制允许的密钥的最小Wi-Fi长度为 8。The enforced minimum allowed length of the Wi-Fi key is 8.

MinWifisSIDLengthMinWifiSSIDLength

重要 Windows Phone 8.1 不再支持此面值。Important This parm is no longer supported for Windows Phone 8.1. SSID 中强制允许的最小Wi-Fi长度为 1。The enforced minimum allowed length of the Wi-Fi SSID is 1.

CDMA 网络的其他要求Additional requirements for CDMA networks

对于使用单独的网络访问标识 (NAI) 进行 Internet 共享的 CDMA 网络 ,CM_CellularEntries 配置服务提供程序配置服务提供程序中添加了一个新参数 TetheringNAI。For CDMA networks that use a separate Network Access Identity (NAI) for Internet sharing, a new parm, TetheringNAI, has been added in the CM_CellularEntries configuration service provider configuration service provider. 以下示例演示如何指定连接。The following sample demonstrates how to specify the connection.

<wap-provisioningdoc>
    <characteristic type="CM_CellularEntries">
        <characteristic type="TetheringNAIConn">
            <parm name="Version" value="1"/>
            <parm name="UserName" value=""/>
            <parm name="Password" value=""/>
            <parm name="TetheringNAI" value="1"/>
        </characteristic>
    </characteristic>
    <characteristic type="HotSpot">
        <parm name="Enabled" value="true" datatype="boolean"/>
        <parm name="EntitlementRequired" value="false" datatype="boolean"/>
        <parm name="TetheringNAIConnection" value="TetheringNAIConn" datatype="string"/>
    </characteristic>
</wap-provisioningdoc>

注意 CDMA 设备一次只能有一个活动数据连接。Note CDMA devices are limited to one active data connection at a time. 这意味着任何应用程序或服务 (,如电子邮件或彩信) 绑定到另一个连接在 Internet 共享打开时可能不起作用。This means any application or service (such as email or MMS) that is bound to another connection may not work while Internet sharing is turned on.

创建权利 DLLCreating an Entitlement DLL

对于需要权利检查的移动运营商网络,OEM 必须在设备映像中提供一个 DLL,用于实现具有以下签名的函数:For mobile operator networks that require an entitlement check, the OEM must provide a DLL in the device image that implements a function with the following signature:

ICS_ENTITLEMENT_RESULT IsEntitled(void);

HotSpot 配置服务提供程序的 parm 必须设置为作为此 DLL 路径 EntitlementDll 的字符串。The EntitlementDll parm of the HotSpot configuration service provider must be set to a string that is the path to this DLL.

DLL 必须以特定方式进行代码签名,请参阅签署 二进制文件和程序包The DLL must be code signed in a specific way, see Sign binaries and packages.

在权利检查过程中,Internet 共享服务加载指定的 DLL,然后调用 IsEntitled 函数。During an entitlement check the Internet Sharing service loads the specified DLL and then call the IsEntitled function. 函数必须连接到服务器才能执行任何所需的验证,然后返回以下 ICS_ENTITLEMENT_RESULT 枚举值之一。The function must connect to the server to perform any required validation, then return one of the following ICS_ENTITLEMENT_RESULT enumeration values.

Value 描述Description

ENTITLEMENT_SUCCESSENTITLEMENT_SUCCESS

允许设备连接到服务器。The device is allowed to connect to the server.

ENTITLEMENT_FAILEDENTITLEMENT_FAILED

不允许设备连接到服务器The device is not allowed to connect to the server

ENTITLEMENT_UNAVAILABLEENTITLEMENT_UNAVAILABLE

权利检查失败,因为设备无法与服务器联系或无法获取连接来验证权利。The entitlement check failed because the device could not contact the server or acquire a connection to verify entitlement.

ICS_ENTITLEMENT_RESULT的定义位于头文件中,该文件随 IcsEntitlementh Windows 安装工具包一起提供。The definition for the ICS_ENTITLEMENT_RESULT is in the header file IcsEntitlementh, which ships with the Windows Adaptation Kit.

配置服务提供程序参考Configuration service provider reference