Metodo IWCNDevice::SetPassword (wcndevice.h)

Articolo
08/27/2023

Il metodo IWCNDevice::SetPassword configura il valore del metodo di autenticazione e, se necessario, una password usata per la sessione in sospeso. Questo metodo può essere chiamato solo prima di IWCNDevice::Connect.

Sintassi

HRESULT SetPassword(
  [in] WCN_PASSWORD_TYPE Type,
  [in] DWORD             dwPasswordLength,
  [in] const BYTE []     pbPassword
);

Parametri

[in] Type

Valore WCN_PASSWORD_TYPE che specifica il metodo di autenticazione utilizzato per la sessione.

Valore	Significato
WCN_PASSWORD_TYPE_PUSH_BUTTON	Usare l'autenticazione PushButton. Il valore di dwPasswordLength deve essere NULL.
WCN_PASSWORD_TYPE_PIN	Usare l'autenticazione basata su PIN.

[in] dwPasswordLength

Numero di byte nel buffer pbPassword.

[in] pbPassword

Matrice di byte della password, codificata in ASCII.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	La password verrà usata per la sessione in sospeso.
E_INVALIDARG	Il tipo di password è WCN_PASSWORD_TYPE_PUSH_BUTTON e la lunghezza della password non è zero. Il tipo di password non è WCN_PASSWORD_TYPE_PUSH_BUTTON o WCN_PASSWORD_TYPE_PIN.

Commenti

La matrice di byte non è con terminazione NULL. Ad esempio, se la password è un PIN a 4 cifre, è necessario passare dwPasswordLength come 4 e pbPassword deve puntare a una matrice a 4 byte contenente il PIN in ASCII.

Requisiti


Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	wcndevice.h

Vedi anche

IWCNDevice

IWCNDevice::Connect

WCN_PASSWORD_TYPE

Condividi tramite