Método IMbnRegistration::GetRegisterState (mbnapi.h)

Obtém o estado de registro.

Sintaxe

HRESULT GetRegisterState(
  [out] MBN_REGISTER_STATE *registerState
);

Parâmetros

[out] registerState

Um ponteiro de um valor MBN_REGISTER_STATE que especifica para o estado de registro atual do dispositivo. O valor será significativo somente se o método tiver retornado S_OK.

Valor retornado

Esse método pode retornar um desses valores.

Comentários

O método GetRegisterState obtém o estado de registro de rede atual do dispositivo. O dispositivo pode ser registrado em uma rede, pesquisando na rede para registro ou pode ser negado o registro.

O estado de registro do dispositivo pode ser alterado automaticamente. Por exemplo, quando o dispositivo sai da área de cobertura de rede, ele altera o estado de registro de MBN_REGISTER_STATE_HOME para MBN_REGISTER_STATE_SEARCHING.

Um aplicativo pode se registrar para receber atualizações de alteração de estado de registro conectando a interface IMbnRegistrationEvents . O Windows chamará o método OnRegisterStateChange de IMbnRegistrationEvents para notificar o aplicativo sobre essas alterações.

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

Confira também

IMbnRegistration