IMbnInterface：：GetHomeProvider 方法 (mbnapi.h)
重要
從 Windows 10 1803 版開始，本節所述的 WIN32 API 會由Windows.Networking.Connectivity命名空間中的 Windows 執行階段 API 取代。
取得主提供者。
語法
HRESULT GetHomeProvider(
[out, retval] MBN_PROVIDER *homeProvider
);
參數
[out, retval] homeProvider
表示主提供者 之MBN_PROVIDER 結構的指標。 如果這個方法傳回 S_OK以外的任何值，則此參數為 Null。 完成時，呼叫端應用程式必須呼叫SysFreeString，以釋放配置給providerID和providerName成員MBN_PROVIDER的記憶體
傳回值
這個方法可以傳回下列其中一個值。
| 傳回碼 | 描述 |
|---|---|
|
已成功完成命令。 homeProvider 包含有效值。 |
|
資訊無法使用。 行動寬頻服務目前正在探查以取得住家提供者。 呼叫端應用程式可以藉由註冊IMbnInterfaceEvents的OnHomeProviderAvailable方法，在首頁提供者可供使用時收到通知。 |
|
裝置要求必須為此作業輸入 PIN。 |
|
不會插入 SIM 卡。 |
|
在裝置中插入錯誤的 SIM 卡。 |
|
無法從 SIM 卡或裝置記憶體讀取。 例如，SIM 卡並未布建首頁提供者資訊。 |
備註
GetHomeProvider 會傳回裝置的主提供者資訊。 應該忽略傳回MBN_PROVIDER結構的dataClass欄位。
針對可復原的錯誤 E_MBN_PIN_REQUIRED、 E_MBN_SIM_NOT_INSERTED和 E_MBN_BAD_SIM，當錯誤狀況超過時，行動寬頻服務會重新查詢首頁提供者的裝置。 例如，如果裝置需要輸入 PIN 才能擷取這項資訊，則會 傳回E_MBN_PIN_REQUIRED。 當應用程式輸入 PIN 以解除鎖定裝置時，行動寬頻服務會再次嘗試從裝置取得此資訊。 系統會呼叫IMbnInterfaceEvents的OnHomeProviderAvailable方法，以更新應用程式有關新查詢的狀態。
IMbnInterfaceEvents的已註冊OnHomeProviderAvailable方法可以在首頁提供者資訊可用或新查詢完成時呼叫，並出現錯誤。 一旦此函式傳回成功，這項資訊永遠不會變更。
需求
| 最低支援的用戶端 | Windows 7 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | 都不支援 |
| 目標平台 | Windows |
| 標頭 | mbnapi.h |