Compartilhar via


Método IMbnRegistration::GetRegisterMode (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 modo de registro de rede de um dispositivo de Banda Larga Móvel.

Sintaxe

HRESULT GetRegisterMode(
  [out] MBN_REGISTER_MODE *registerMode
);

Parâmetros

[out] registerMode

Um ponteiro para um valor MBN_REGISTER_MODE que especifica o modo de registro de rede atual do dispositivo. O valor será significativo somente se o método retornar S_OK.

Valor retornado

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
A operação foi bem-sucedida.
E_PENDING
O modo de registro 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 modo de registro estiver disponível, o serviço de Banda Larga Móvel chamará o método OnRegisterModeAvailable de IMbnRegistrationEvents.
E_MBN_PIN_REQUIRED
Um PIN é necessário para obter o modo de registro.
E_MBN_SIM_NOT_INSERTED
Um SIM não é inserido no dispositivo.
E_MBN_BAD_SIM
Um SIM incorreto é inserido no dispositivo.

Comentários

Consulte MBN_REGISTER_MODE para obter detalhes sobre possíveis modos de registro.

Para erros recuperáveis 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, o serviço de Banda Larga Móvel chamará o método OnRegisterModeAvailable 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

Confira também

IMbnRegistration