IMbnInterface：：GetSubscriberInformation 方法 (mbnapi.h)

  • 项目

重要

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

获取订阅者信息。

语法

HRESULT GetSubscriberInformation(
  [out, retval] IMbnSubscriberInformation **subscriberInformation
);

参数

[out, retval] subscriberInformation

指向 IMbnSubscriberInformation 接口地址的指针，该接口包含设备的订阅者信息。 如果此方法返回 除 S_OK 以外的任何值，则此参数为 NULL。

返回值

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

返回代码 说明
S_OK
 该方法已成功完成。 subscriberInformation 包含有效的接口。
E_PENDING
 该信息不可用。 移动宽带服务目前正在探测这些信息。 通过注册 IMbnInterfaceEvents 的 OnSubscriberInformationChange 方法，调用应用程序可以在信息可用时收到通知。

注解

GetSubscriberInformation 方法返回与订阅者相关的信息，包括订阅者 ID、SIM 国际线路卡号码以及与此接口关联的电话号码。

从具有移动运营商权限的 Windows 应用商店应用调用此方法时，它将仅返回 SIM 国际线路卡 SimIccID 属性定义的号码。

仅当MBN_READY_STATE_INITIALIZED IMbnInterface的 GetReadyState 方法报告的就绪状态时，才会填充订阅者信息中返回的某些值。 每当与移动宽带设备关联的订阅者信息发生更改时，移动宽带服务将通过调用 IMbnInterfaceEvents 的 OnSubscriberInformationChange 方法通知已注册的应用程序。

设备就绪状态 MBN_READY_STATE_INITIALIZED后，设备的订阅者信息不会更改。

要求

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

另请参阅

IMbnInterface