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 方法會傳回訂閱者相關信息，包括訂閱者標識碼、SIM 國際線路卡號碼，以及與此介面相關聯的電話號碼。
從具有電信業者許可權的 Windows 市集應用程式呼叫此方法時，只會傳回 SimIccID 屬性所定義的 SIM International 線路卡號碼。
只有在 IMbnInterface 的 GetReadyState 方法回報的就緒狀態MBN_READY_STATE_INITIALIZED時，才會填入訂閱者資訊中傳回的部分值。 每當與行動寬頻裝置相關聯的訂閱者資訊有所變更時，行動寬頻服務會呼叫 IMbnInterfaceEvents 的 OnSubscriberInformationChange 方法來通知已註冊的應用程式。
當裝置就緒狀態 MBN_READY_STATE_INITIALIZED之後，裝置的訂閱者資訊將不會變更。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 7 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | 都不支援 |
| 目標平台 | Windows |
| 標頭 | mbnapi.h |