IWCNDevice::SetPassword-Methode (wcndevice.h)

Artikel
08/27/2023

Die IWCNDevice::SetPassword-Methode konfiguriert den Wert der Authentifizierungsmethode und bei Bedarf ein Kennwort, das für die ausstehende Sitzung verwendet wird. Diese Methode kann nur vor IWCNDevice::Connect aufgerufen werden.

Syntax

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

Parameter

[in] Type

Ein WCN_PASSWORD_TYPE Wert, der die für die Sitzung verwendete Authentifizierungsmethode angibt.

Wert	Bedeutung
WCN_PASSWORD_TYPE_PUSH_BUTTON	Verwenden Sie die PushButton-Authentifizierung. Der Wert von dwPasswordLength muss NULL sein.
WCN_PASSWORD_TYPE_PIN	Verwenden Sie die PIN-basierte Authentifizierung.

[in] dwPasswordLength

Anzahl der Bytes im Puffer pbPassword.

[in] pbPassword

Ein Bytearray des Kennworts, codiert in ASCII.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Das Kennwort wird für die ausstehende Sitzung verwendet.
E_INVALIDARG	Der Kennworttyp ist WCN_PASSWORD_TYPE_PUSH_BUTTON und die Kennwortlänge ist nicht 0. Der Kennworttyp ist nicht WCN_PASSWORD_TYPE_PUSH_BUTTON oder WCN_PASSWORD_TYPE_PIN.

Hinweise

Das Bytearray ist nicht NULL-beendet. Wenn das Kennwort beispielsweise eine 4-stellige PIN ist, sollten Sie dwPasswordLength als 4 übergeben, und pbPassword sollte auf ein 4-Byte-Array zeigen, das die PIN in ASCII enthält.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	wcndevice.h

Weitere Informationen

IWCNDevice

IWCNDevice::Connect

WCN_PASSWORD_TYPE

Freigeben über