IMbnRegistrationEvents：：OnSetRegisterModeComplete 方法 (mbnapi.h)

重要

从 Windows 10 版本 1803 开始，本部分所述的 Win32 API 将替换为 Windows.Networking.Connectivity 命名空间中的Windows 运行时 API。

移动宽带服务调用的通知方法，指示它已完成设置注册操作。

语法

HRESULT OnSetRegisterModeComplete(
  [in] IMbnRegistration *newInterface,
  [in] ULONG            requestID,
  [in] HRESULT          status
);

[in] newInterface

指向表示适用设备的 IMbnRegistration 接口的指针。处理应用程序可以使用此接口获取设备的当前注册状态。

[in] requestID

移动宽带服务分配用于跟踪设置注册操作的请求 ID。

[in] status

指示操作结果的状态代码。

调用应用程序可以期待其中一个可能的值。

值	含义
S_OK	操作成功。
HRESULT_FROM_WIN32 (ERROR_INVALID_STATE)	已存在活动的网络连接。如果已建立数据连接，则无法更改注册模式。应用程序应首先断开连接，然后尝试更改注册模式。如果设备已处于请求模式并连接到请求的提供程序，则将 S_OK返回代码。
HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED)	设备不支持此操作。不支持所请求的注册模式的设备可能会返回此值。例如，当请求切换到手动注册模式时，CDMA 设备将返回此错误。
E_FAIL	操作无法完成。有关详细信息，请参阅网络错误代码。
E_INVALIDARG	无效的注册模式输入或作为输入提供的提供程序 ID 超过最大长度 7 个字符，或者提供的数据类无效。在输入中提供无效参数时，移动宽带服务不会将请求发送到设备。在手动注册模式下，这表示请求的提供程序被禁止。
E_MBN_PIN_REQUIRED	操作需要 PIN 才能完成。
E_MBN_SERVICE_NOT_ACTIVATED	网络服务订阅已过期。
E_MBN_PROVIDER_NOT_VISIBLE	仅当切换到手动注册模式时，才会发生这种情况。切换成功，但请求的提供程序不可见。当设备可见时，设备将注册到请求的提供程序。

此方法必须返回 S_OK。