IMbnRegistration：：GetCurrentDataClass 方法 (mbnapi.h)

重要

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

获取当前网络中的当前数据类。

语法

HRESULT GetCurrentDataClass(
  [out] ULONG *currentDataClass
);

[out] currentDataClass

指向 MBN_DATA_CLASS 值的指针。仅当函数返回 S_OK时，此参数才有意义。

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

返回代码	说明
S_OK	操作成功。
E_PENDING	数据类不可用。移动宽带服务当前正在探测设备中的信息。当数据类可用时，移动宽带服务将调用 IMbnRegistrationEvents 的 OnPacketServiceStateChange 方法。
E_MBN_PIN_REQUIRED	获取数据类需要 PIN。
E_MBN_SIM_NOT_INSERTED	设备中未插入 SIM 卡。
E_MBN_BAD_SIM	设备中插入了错误的 SIM 卡。

GetCurrentDataClass 方法返回当前网络中的数据类。如果值未知，则可以将此值设置为 MBN_DATA_CLASS_NONE 。

当设备从一个手机网络移动到另一个手机网络时，当前数据类可能会自动更改。每当发生此类更改时，移动宽带服务将通过调用 IMbnRegistrationEvents 的 OnPacketServiceStateChange 方法通知应用程序。

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