IMbnRegistration：：GetRoamingText 方法 (mbnapi.h)
重要
从 Windows 10 版本 1803 开始，本部分所述的 Win32 API 将替换为 Windows.Networking.Connectivity 命名空间中的Windows 运行时 API。
获取描述漫游提供程序的漫游文本。
语法
HRESULT GetRoamingText(
[out] BSTR *roamingText
);
parameters
[out] roamingText
指向包含设备漫游网络的其他信息的字符串的指针。 最大长度为 MBN_ROAMTEXT_LEN 个字符。 仅当方法返回 成功S_OK 时，才会填充字符串。 成功后，调用应用程序必须通过调用 SysFreeString 释放分配的内存。
返回值
此方法可以返回其中一个值。
| 返回代码 | 说明 |
|---|---|
|
操作成功。 |
|
漫游文本不可用。 移动宽带服务当前正在探测设备以获取信息。 当漫游文本可用时，移动宽带服务将调用 IMbnRegistrationEvents 的 OnRegisterModeAvailable 方法。 |
|
需要 PIN 才能获取漫游文本。 |
|
不会在设备中插入 SIM 卡。 |
|
设备中插入了错误的 SIM 卡。 |
注解
当注册状态MBN_REGISTER_STATE_PARTNER或MBN_REGISTER_STATE_ROAMING时，GetRoamingText 方法可以获取包含有关网络的其他信息的文本字符串。
当移动宽带设备从一个网络移动到另一个网络时，此信息可能会更改。 这包括每当网络注册状态从 MBN_REGISTER_STATE_HOME 更改为 MBN_REGISTER_STATE_SEARCHING 时。 当已注册的网络发生更改时，例如当网络将其注册从一个提供程序移动到另一个提供程序时，也会发生这种情况。 进行此类更改后，移动宽带服务将调用 IMbnRegistrationEvents 的 OnRegisterStateChange 方法。
对于可恢复的错误 E_MBN_PIN_REQUIRED，当错误条件超过 (时，移动宽带服务将再次尝试从设备提取此信息，当输入 PIN 时) 。 然后，它将调用 IMbnRegistrationEvents 的 OnRegisterStateChange 方法。
要求
| 最低受支持的客户端 | Windows 7 [桌面应用 |UWP 应用] |
| 最低受支持的服务器 | 无受支持的版本 |
| 目标平台 | Windows |
| 标头 | mbnapi.h |