Méthode IWCNDevice::SetPassword (wcndevice.h)

Article
08/27/2023

La méthode IWCNDevice::SetPassword configure la valeur de la méthode d’authentification et, si nécessaire, un mot de passe utilisé pour la session en attente. Cette méthode peut uniquement être appelée avant IWCNDevice::Connect.

Syntaxe

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

Paramètres

[in] Type

Valeur WCN_PASSWORD_TYPE qui spécifie la méthode d’authentification utilisée pour la session.

Valeur	Signification
WCN_PASSWORD_TYPE_PUSH_BUTTON	Utilisez l’authentification PushButton. La valeur de dwPasswordLength doit être NULL.
WCN_PASSWORD_TYPE_PIN	Utilisez l’authentification basée sur le code confidentiel.

[in] dwPasswordLength

Nombre d’octets dans la mémoire tampon pbPassword.

[in] pbPassword

Tableau d’octets du mot de passe, encodé en ASCII.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour	Description
S_OK	Le mot de passe sera utilisé pour la session en attente.
E_INVALIDARG	Le type de mot de passe est WCN_PASSWORD_TYPE_PUSH_BUTTON et la longueur du mot de passe n’est pas égale à zéro. Le type de mot de passe n’est ni WCN_PASSWORD_TYPE_PUSH_BUTTON ni WCN_PASSWORD_TYPE_PIN.

Remarques

Le tableau d’octets n’est pas terminé par null. Par exemple, si le mot de passe est un code confidentiel à 4 chiffres, vous devez passer dwPasswordLength comme 4 et pbPassword doit pointer vers un tableau de 4 octets contenant le code pin en ASCII.

Configuration requise


Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	wcndevice.h

Voir aussi

IWCNDevice

IWCNDevice::Connect

WCN_PASSWORD_TYPE

Partager via