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时,此参数才有意义。

返回值

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

返回代码 说明
S_OK
操作成功。
E_PENDING
数据类不可用。 移动宽带服务当前正在探测设备以获取信息。 当数据类可用时,移动宽带服务将调用 IMbnRegistrationEventsOnPacketServiceStateChange 方法。
E_MBN_PIN_REQUIRED
需要 PIN 才能获取数据类。

注解

GetAvailableDataClasses 返回当前网络中可能的数据类集。 如果值未知,可以将这些值设置为 MBN_DATA_CLASS_NONE

当设备从一个单元格移动到另一个单元格时,可用数据类可能会自动更改。 每当发生此类更改时,移动宽带服务都会通过调用 IMbnRegistrationEventsOnPacketServiceStateChange 方法通知应用程序。

对于可恢复的错误 E_MBN_PIN_REQUIRED,当错误条件超过 (时,移动宽带服务将再次尝试从设备提取此信息,当输入 PIN 时) 。 之后,移动宽带服务将调用 IMbnRegistrationEventsOnPacketServiceStateChange 方法。

要求

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

另请参阅

IMbnRegistration