Metodo IMbnPin::Unblock (mbnapi.h)

Articolo
02/28/2024

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.

Sblocca un PIN bloccato.

Sintassi

HRESULT Unblock(
  [in]  LPCWSTR puk,
  [in]  LPCWSTR newPin,
  [out] ULONG   *requestID
);

Parametri

[in] puk

Valore della chiave di sblocco della password (PUK) per questo tipo di PIN.

[in] newPin

Nuovo PIN da impostare per questo tipo di PIN.

[out] requestID

ID richiesta impostato dal servizio Mobile Broadband per identificare questa richiesta asincrona.

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	Interfaccia non valida. Il dispositivo Mobile Broadband è stato probabilmente rimosso dal sistema.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	Interfaccia non valida. Molto probabilmente il dispositivo Mobile Broadband è stato rimosso dal sistema.
E_ACCESSDENIED	Questo metodo non è consentito per chiamare i privilegi del processo.

Commenti

Il metodo Unblock sblocca il PIN per il tipo di pin immettendo il PUK e imposta un nuovo PIN. La proprietà PinType di questo IMbnPin rappresenta il tipo di PIN da modificare.

Si tratta di un'operazione asincrona, Se il metodo viene restituito con esito positivo, al termine dell'operazione, il servizio Mobile Broadband chiamerà il metodo OnUnblockComplete di IMbnPinEvents.

Ogni volta che il metodo GetPinState di IMbnPinManager restituisce i risultati con lo stato PIN corrente impostato su MBN_PIN_STATE_UNBLOCK, l'applicazione deve usare Unblock sul tipo di PIN restituito in PinInfo.pinType passato dal metodo OnGetPinStateComplete di IMbnPinManagerEvents.

Per richiamare questo metodo sono necessari privilegi di amministratore.

Requisiti

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

Vedi anche

IMbnPin

Condividi tramite