Metodo IMbnRegistration::GetRegisterState (mbnapi.h)

Ottiene lo stato di registrazione.

Sintassi

HRESULT GetRegisterState(
  [out] MBN_REGISTER_STATE *registerState
);

Parametri

[out] registerState

Puntatore a un valore MBN_REGISTER_STATE che specifica lo stato di registrazione corrente del dispositivo. Il valore è significativo solo se il metodo ha restituito S_OK.

Valore restituito

Questo metodo può restituire uno di questi valori.

Commenti

Il metodo GetRegisterState ottiene lo stato di registrazione di rete corrente del dispositivo. Il dispositivo può essere registrato in una rete, cercando nella rete la registrazione o può essere negata la registrazione.

Lo stato di registrazione del dispositivo può cambiare automaticamente. Ad esempio, quando il dispositivo esce dall'area di copertura della rete, cambia lo stato di registrazione da MBN_REGISTER_STATE_HOME a MBN_REGISTER_STATE_SEARCHING.

Un'applicazione può registrarsi per ricevere gli aggiornamenti delle modifiche dello stato di registrazione connettendo l'interfaccia IMbnRegistrationEvents . Windows chiamerà il metodo OnRegisterStateChange di IMbnRegistrationEvents per notificare all'applicazione queste modifiche.

Per l'errore ripristinabile E_MBN_PIN_REQUIRED, il servizio Mobile Broadband tenterà nuovamente di recuperare queste informazioni dal dispositivo quando la condizione di errore è finita (quando viene immesso un PIN). Chiamerà quindi il metodo OnRegisterStateChange di IMbnRegistrationEvents.

Requisiti

Vedi anche

IMbnRegistration