Método IMbnRegistration::GetProviderName (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 nome do provedor para a rede registrada no momento.
Sintaxe
HRESULT GetProviderName(
[out] BSTR *providerName
);
Parâmetros
[out] providerName
Ponteiro para uma cadeia de caracteres que contém o nome do provedor registrado no momento. O comprimento máximo dessa cadeia de caracteres é MBN_PROVIDERNAME_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 nome do provedor 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 nome do provedor 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 nome do provedor. |
|
Um SIM não é inserido no dispositivo. |
|
Um SIM incorreto é inserido no dispositivo. |
Comentários
O nome do provedor pode ser alterado quando o dispositivo de Banda Larga Móvel passa de uma rede para outra. Isso inclui sempre que há 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 altera 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. Quando isso acontece, o aplicativo deve chamar GetProviderID.
Para o erro recuperável E_MBN_PIN_REQUIRED, o serviço de Banda Larga Móvel tentará refetuar 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 |