通过

IMbnRegistration：：SetRegisterMode 方法 (mbnapi.h)

  • 项目

重要

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

设置设备的注册模式。

语法

HRESULT SetRegisterMode(
  [in]  MBN_REGISTER_MODE registerMode,
  [in]  LPCWSTR           providerID,
  [in]  ULONG             dataClass,
  [out] ULONG             *requestID
);

parameters

[in] registerMode

一个指定新注册模式 的 MBN_REGISTER_MODE 值。

[in] providerID

一个字符串，指定要注册到的网络提供程序的提供程序 ID。 MBN_REGISTER_MODE_AUTOMATICregisterMode 时必须为 NULL。

[in] dataClass

OR 的按位组合 MBN_DATA_CLASS 值，用于指定连接的首选数据访问技术。 移动宽带服务将注册此列表中可用的最高数据类技术。 如果此列表中没有任何数据类可以注册到，则移动宽带服务将注册到最佳可用数据类。

[out] requestID

由移动宽带服务设置的请求 ID，用于标识此异步请求。

返回值

此方法可以返回其中一个值。

返回代码 说明
S_OK
 该方法已成功完成。
HRESULT_FROM_WIN32 (ERROR_SERVICE_NOT_ACTIVE)
移动宽带服务未在此系统上运行。
E_HANDLE
 接口无效，很可能是因为移动宽带设备已从系统中删除。
HRESULT_FROM_WIN32 (ERROR_NOT_FOUND)
接口无效。 很可能移动宽带设备已从系统中删除。
HRESULT_FROM_WIN32 (ERROR_INVALID_STATE)
已有活动的网络连接。 如果已建立数据连接，则无法更改注册模式。 调用应用程序应首先断开连接，然后尝试更改注册模式。 如果设备已处于请求的模式并连接到请求的提供程序，则将 S_OK返回代码。

注解

SetRegisterMode 方法可用于将设备设置为自动或手动网络选择模式。 对于手动注册模式，设备应注册到的网络 ID 在 providerID 中提供。

支持手动注册模式是可选的，应用程序应通过检查 iMbnInterface 的 GetInterfaceCapability 方法填充的 interfaceCaps 参数中的MBN_CTRL_CAPS_REG_MANUAL来验证设备是否支持手动注册。 如果应用程序设置了手动注册模式，但设备不支持该模式，则此调用将返回 HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED) 。

SetRegisterMode 是异步的，将立即返回。 如果没有错误，则操作完成后，移动宽带服务将调用 IMbnRegistrationEvents 的 OnSetRegisterModeComplete 方法。

要求

   
最低受支持的客户端 Windows 7 [桌面应用 |UWP 应用]
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 mbnapi.h

另请参阅

IMbnRegistration