Metodo IMbnPinManager::GetPinState (mbnapi.h)

  • Articolo

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.

Ottiene lo stato del PIN corrente del dispositivo.

Sintassi

HRESULT GetPinState(
  [out] ULONG *requestID
);

Parametri

[out] requestID

Puntatore all'ID richiesta impostato dal servizio Mobile Broadband per questa richiesta asincrona. La risposta conterrà lo stesso ID richiesta.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito Descrizione
S_OK
 Metodo completato correttamente.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)
 Il servizio Mobile Broadband non è in esecuzione in questo sistema.
E_HANDLE
 L'interfaccia non è valida, molto probabilmente perché il dispositivo Mobile Broadband è stato rimosso dal sistema.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)
 L'interfaccia non è valida. Molto probabilmente il dispositivo Mobile Broadband è stato rimosso dal sistema.

Commenti

Il metodo GetPinState avvia una richiesta asincrona per lo stato del PIN del dispositivo. Lo stato del PIN indica se è necessario immettere un PIN per completare un'operazione richiesta. Contiene anche informazioni sul tipo di PIN previsto da un dispositivo e, facoltativamente, fornisce il numero di tentativi rimanenti per l'immissione di un PIN valido.

Questo metodo restituisce sempre lo stato DEL PIN corrente del dispositivo. Non memorizza nella cache lo stato del PIN al momento della creazione di questo oggetto. Al contrario, contatta sempre il dispositivo e restituisce lo stato del PIN corrente del dispositivo.

Poiché si tratta di un'operazione asincrona, GetPinState restituirà immediatamente. Al termine dell'operazione, il servizio Mobile Broadband chiamerà il metodo OnGetPinStateComplete di IMbnPinManagerEvents.

Ogni volta che un'operazione restituisce E_MBN_PIN_REQUIRED o lo stato pronto segnalato dal dispositivo è MBN_READY_STATE_DEVICE_LOCKED, un'applicazione deve usare questo metodo per eseguire una query sul tipo di PIN necessario per sbloccare il dispositivo o la SIM.

Mentre questa operazione è in corso, se il dispositivo Mobile Broadband viene rimosso dal sistema, non è garantita una chiamata al metodo OnGetPinStateComplete di IMbnPinManagerEvents .

Requisiti

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

Vedi anche

IMbnPinManager