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