IWCNDevice::SetPassword-Methode (wcndevice.h)

  • Artikel

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