Metodo IMbnPinManagerEvents::OnGetPinStateComplete (mbnapi.h)

Metodo di notifica chiamato dal servizio Mobile Broadband per indicare il completamento di un'operazione asincrona attivata da una chiamata al metodo GetPinState di IMbnPinManager.

Sintassi

HRESULT OnGetPinStateComplete(
  [in] IMbnPinManager *pinManager,
  [in] MBN_PIN_INFO   pinInfo,
  [in] ULONG          requestID,
  [in] HRESULT        status
);

Parametri

[in] pinManager

Puntatore a un'interfaccia IMbnPinManager che rappresenta il dispositivo Mobile Broadband per cui è stata eseguita l'operazione.

[in] pinInfo

Struttura MBN_PIN_INFO che contiene le informazioni sul PIN del dispositivo.

Se pinInfo.pinState è impostato su MBN_PIN_STATE_NONE , non è previsto che venga immesso alcun PIN dal dispositivo.

Se pinInfo.pinState è impostato su MBN_PIN_STATE_ENTER , il dispositivo prevede l'immissione di un PIN e pinInfo.pinType rappresenta il tipo di PIN previsto dal dispositivo.

Se pinInfo.pinState è impostato su MBN_PIN_STATE_UNBLOCK , il dispositivo è bloccato e un'operazione di sblocco del PIN deve essere tentata di sbloccare il dispositivo. In questo caso , pinInfo.pinType rappresenta il tipo di PIN in cui deve essere eseguita l'operazione di sblocco.

Se pinInfo.pinState è impostato su MBN_PIN_STATE_ENTER o MBN_PIN_STATE_UNBLOCK, pinInfo.attemptsRemaining contiene il numero di tentativi rimanenti per immettere un PIN o una chiave di sblocco PIN (PUK) valida. Se il numero di tentativi rimanenti è sconosciuto, pinInfo.attemptsRemaining è impostato su MBN_ATTEMPTS_REMAINING_UNKNOWN.

[in] requestID

ID richiesta assegnato dal servizio Mobile Broadband per identificare questa operazione.

[in] status

Stato di completamento dell'operazione.

Un'applicazione chiamante può prevedere uno dei valori seguenti.

Valore restituito

Questo metodo deve restituire S_OK.

Commenti

Questo metodo viene chiamato dal servizio Mobile Broadband per notificare a un'applicazione il completamento di un'operazione asincrona attivata da una chiamata al metodo GetPinState di IMbnPinManager.
Al completamento, pinInfo contiene informazioni sul PIN previsto successivamente dal dispositivo.

Requisiti

Vedi anche

IMbnPinManagerEvents