IMbnRegistration：：GetProviderName 方法 (mbnapi.h)
重要
從 Windows 10 1803 版開始，本節所述的 WIN32 API 會由Windows.Networking.Connectivity命名空間中的 Windows 執行階段 API 取代。
取得目前已註冊網路的提供者名稱。
語法
HRESULT GetProviderName(
[out] BSTR *providerName
);
參數
[out] providerName
字串的指標，其中包含目前已註冊提供者的名稱。 此字串的最大長度是 MBN_PROVIDERNAME_LEN 個字元。 只有在方法傳回 S_OK 以成功時，才會填入字串。 成功時，呼叫端應用程式必須呼叫 SysFreeString來釋放配置的記憶體。
傳回值
這個方法可以傳回其中一個值。
| 傳回碼 | 描述 |
|---|---|
|
作業成功。 |
|
提供者名稱無法使用。 行動寬頻服務目前正在探查裝置中的資訊。 當提供者名稱可用時，行動寬頻服務會呼叫IMbnRegistrationEvents的OnRegisterModeAvailable方法。 |
|
需要 PIN 才能取得提供者名稱。 |
|
SIM 卡不會插入裝置中。 |
|
在裝置中插入不正確的 SIM 卡。 |
備註
當行動寬頻裝置從一個網路移至另一個網路時，提供者名稱可能會變更。 這包括每當網路註冊狀態從 MBN_REGISTER_STATE_HOME 變更為 MBN_REGISTER_STATE_SEARCHING 時。 當已註冊的網路發生變更時，也會發生這種情況，例如當網路從一個提供者變更其註冊到另一個提供者時。 這類變更之後，行動寬頻服務會呼叫IMbnRegistrationEvents的OnRegisterStateChange方法。 發生這種情況時，應用程式應該呼叫 GetProviderID。
針對可復原的錯誤 E_MBN_PIN_REQUIRED，行動寬頻服務會在輸入 PIN 時嘗試從裝置重新參考這項資訊， (輸入 PIN 時) (。 然後它會呼叫IMbnRegistrationEvents的OnRegisterStateChange方法。
需求
| 最低支援的用戶端 | Windows 7 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | 都不支援 |
| 目標平台 | Windows |
| 標頭 | mbnapi.h |