IMbnRegistration::GetAvailableDataClasses 方法 (mbnapi.h)
重要
从 Windows 10 版本 1803 开始,本部分所述的 Win32 API 将替换为 Windows.Networking.Connectivity 命名空间中的Windows 运行时 API。
获取当前网络中可用的数据类。
语法
HRESULT GetAvailableDataClasses(
[out] ULONG *availableDataClasses
);
参数
[out] availableDataClasses
指向 MBN_DATA_CLASS 值的按位 OR 组合的指针。 仅当函数返回 S_OK时,此参数才有意义。
返回值
此方法可以返回其中一个值。
返回代码 | 说明 |
---|---|
|
操作成功。 |
|
数据类不可用。 移动宽带服务当前正在探测设备以获取信息。 当数据类可用时,移动宽带服务将调用 IMbnRegistrationEvents 的 OnPacketServiceStateChange 方法。 |
|
需要 PIN 才能获取数据类。 |
注解
GetAvailableDataClasses 返回当前网络中可能的数据类集。 如果值未知,可以将这些值设置为 MBN_DATA_CLASS_NONE 。
当设备从一个单元格移动到另一个单元格时,可用数据类可能会自动更改。 每当发生此类更改时,移动宽带服务都会通过调用 IMbnRegistrationEvents 的 OnPacketServiceStateChange 方法通知应用程序。
对于可恢复的错误 E_MBN_PIN_REQUIRED,当错误条件超过 (时,移动宽带服务将再次尝试从设备提取此信息,当输入 PIN 时) 。 之后,移动宽带服务将调用 IMbnRegistrationEvents 的 OnPacketServiceStateChange 方法。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 7 [桌面应用 |UWP 应用] |
最低受支持的服务器 | 无受支持的版本 |
目标平台 | Windows |
标头 | mbnapi.h |