Metodo IMbnPinEvents::OnEnableComplete (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 abilitazione del PIN è stata completata.

Sintassi

HRESULT OnEnableComplete(
  [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 abilitazione 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 errata.
E_MBN_FAILURE	Si è verificato un tentativo non riuscito di usare il PIN.

Valore restituito

Questo metodo deve restituire S_OK.

Commenti

Il metodo OnEnableComplete viene chiamato dal servizio Mobile Broadband per segnalare lo stato di completamento di un'operazione di abilitazione del PIN inizializzata da una chiamata al metodo Enable 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 DI 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 tentativiRemaining diventare 0, l'applicazione può chiamare il metodo GetPinState di IMbnPinManager per ottenere il tipo di PIN necessario.

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