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