Metodo IMbnPinEvents::OnUnblockComplete (mbnapi.h)

Articolo
08/24/2023

Importante

A partire da Windows 10 versione 1803, le API Win32 descritte in questa sezione vengono sostituite dalle API Windows Runtime nello spazio dei nomi Windows.Networking.Connectivity.

Metodo di notifica chiamato dal servizio Mobile Broadband per indicare che un'operazione di sblocco del PIN è stata completata

Sintassi

HRESULT OnUnblockComplete(
  [in] IMbnPin      *Pin,
  [in] MBN_PIN_INFO *pinInfo,
  [in] ULONG        requestID,
  [in] HRESULT      status
);

Parametri

[in] Pin

Interfaccia IMbnPin che rappresenta il tipo DI PIN.

[in] pinInfo

Puntatore a una struttura MBN_PIN_INFO che contiene informazioni sui tentativi rimanenti, in caso di operazioni di errore. Il contenuto di pinInfo è significativo solo quando lo stato è E_MBN_FAILURE.

[in] requestID

ID richiesta impostato dal servizio Mobile Broadband per identificare la richiesta di sblocco del PIN.

[in] status

Codice di stato che indica il risultato dell'operazione.

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

Valore	Significato
S_OK	L'operazione è stata completata.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Il dispositivo non supporta questa operazione.
E_FAIL	Impossibile completare l'operazione.
E_MBN_PIN_REQUIRED	Per completare l'operazione è necessario un PIN. L'applicazione chiamante può chiamare il metodo GetPinState di IMbnPinManager per individuare il tipo di PIN previsto.
E_MBN_SIM_NOT_INSERTED	Non è presente alcuna SIM nel dispositivo.
E_MBN_BAD_SIM	Nel dispositivo è presente una sim non valida.

Valore restituito

Questo metodo deve restituire S_OK.

Commenti

Il metodo OnUnblockComplete viene chiamato dal servizio Mobile Broadband per segnalare lo stato di completamento di un'operazione di sblocco del PIN inizializzata da una chiamata al metodo Unblock di IMbnPin.

Il contenuto di pinInfo è significativo solo quando lo stato è E_MBN_FAILURE. Il membro pinState deve essere ignorato e il campo pinType è impostato sul tipo PIN dell'interfaccia IMbnPin corrente. Questa struttura contiene i tentativi rimanenti di immettere un PIN valido.

Ad esempio, se il PIN passato per modificare un tipo di PIN non è corretto, l'operazione avrà esito negativo con un codice di stato di E_MBN_FAILURE. In questo caso, pinInfo.attemptsRemaining specifica il numero di tentativi rimanenti per ripetere l'operazione. Se i tentativi ripetuti con il PIN errato causano tentativi Dimaining di diventare 0, l'applicazione può chiamare il metodo GetPinState di IMbnPinManager per ottenere il tipo di PIN richiesto.

Se il dispositivo non riesce a sbloccare e se il blocco PUK è di un pin MBN_PIN_TYPE_PIN1 , verrà inoltre visualizzato lo stato pronto del dispositivo che cambia in MBN_READY_STATE_BAD_SIM. L'applicazione chiamante riceverà una notifica sulla modifica ReadyState tramite il membro OnReadyStateChange di IMbnInterfaceEvents.

Requisiti


Client minimo supportato	Windows 7 [app desktop \| App UWP]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	mbnapi.h

Vedi anche

IMbnPinEvents

Condividi tramite