Método IMbnRegistration::GetRoamingText (mbnapi.h)
Importante
A partir do Windows 10, versão 1803, as APIs do Win32 descritas nesta seção são substituídas pelas APIs Windows Runtime no namespace Windows.Networking.Connectivity.
Obtém o texto móvel que descreve o provedor de roaming.
Sintaxe
HRESULT GetRoamingText(
[out] BSTR *roamingText
);
Parâmetros
[out] roamingText
Ponteiro para uma cadeia de caracteres que contém informações adicionais sobre uma rede com a qual o dispositivo está em roaming. O comprimento máximo é MBN_ROAMTEXT_LEN caracteres. A cadeia de caracteres é preenchida somente quando o método retorna S_OK para êxito. Após o sucesso, o aplicativo de chamada deve liberar a memória alocada chamando SysFreeString.
Valor retornado
Esse método pode retornar um desses valores.
| Código de retorno | Descrição |
|---|---|
|
A operação foi bem-sucedida. |
|
O texto móvel não está disponível. O serviço de Banda Larga Móvel está atualmente sondando o dispositivo para obter as informações. Quando o texto móvel estiver disponível, o serviço de Banda Larga Móvel chamará o método OnRegisterModeAvailable de IMbnRegistrationEvents. |
|
Um PIN é necessário para obter o texto móvel. |
|
Um SIM não é inserido no dispositivo. |
|
Um SIM incorreto é inserido no dispositivo. |
Comentários
O método GetRoamingText pode obter uma cadeia de texto contendo informações adicionais sobre a rede quando o estado de registro é MBN_REGISTER_STATE_PARTNER ou MBN_REGISTER_STATE_ROAMING.
Essas informações podem ser alteradas quando o dispositivo de Banda Larga Móvel passa de uma rede para outra. Isso inclui sempre que há uma alteração de MBN_REGISTER_STATE_HOME para MBN_REGISTER_STATE_SEARCHING no estado de registro de rede. Isso também ocorre quando há uma alteração na rede registrada, como quando uma rede move seu registro de um provedor para outro. Após essas alterações, o serviço de Banda Larga Móvel chamará o método OnRegisterStateChange de IMbnRegistrationEvents.
Para o erro recuperável E_MBN_PIN_REQUIRED, o serviço de Banda Larga Móvel tentará buscar novamente essas informações do dispositivo quando a condição de erro terminar (quando um PIN for inserido). Em seguida, ele chamará o método OnRegisterStateChange de IMbnRegistrationEvents.
Requisitos
| Cliente mínimo com suporte | Windows 7 [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Nenhum compatível |
| Plataforma de Destino | Windows |
| Cabeçalho | mbnapi.h |