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。
返回值
此方法可以返回其中一个值。
返回代码 | 说明 |
---|---|
|
该方法已成功完成。 subscriberInformation 包含有效的接口。 |
|
该信息不可用。 移动宽带服务目前正在探测这些信息。 通过注册 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 |