Metodo IMbnPinEvents::OnChangeComplete (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 è stata completata un'operazione di modifica del PIN.

Sintassi

HRESULT OnChangeComplete(
  [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 modifica del PIN.

[in] status

Codice di stato che indica il risultato dell'operazione di modifica del PIN.

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.
E_MBN_PIN_DISABLED	L'operazione di modifica del PIN non è supportata per il PIN disabilitato.

Valore restituito

Questo metodo deve restituire S_OK.

Commenti

Il metodo OnChangeComplete viene chiamato dal servizio Mobile Broadband per segnalare lo stato di completamento di un'operazione di modifica del PIN inizializzata da una chiamata al metodo Change 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.

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