DsMakePasswordCredentialsW, fonction (ntdsapi.h)
La fonction DsMakePasswordCredentials construit un handle d’informations d’identification adapté à une utilisation avec la fonction DsBindWithCred.
Syntaxe
NTDSAPI DWORD DsMakePasswordCredentialsW(
[in] LPCWSTR User,
[in] LPCWSTR Domain,
[in] LPCWSTR Password,
[out] RPC_AUTH_IDENTITY_HANDLE *pAuthIdentity
);
Paramètres
[in] User
Pointeur vers une chaîne terminée par null qui contient le nom d’utilisateur à utiliser pour les informations d’identification.
[in] Domain
Pointeur vers une chaîne terminée par null qui contient le domaine dont l’utilisateur est membre.
[in] Password
Pointeur vers une chaîne terminée par null qui contient le mot de passe à utiliser pour les informations d’identification.
[out] pAuthIdentity
Pointeur vers une valeur RPC_AUTH_IDENTITY_HANDLE qui reçoit le handle d’informations d’identification. Ce handle est utilisé dans un appel ultérieur à DsBindWithCred. Ce handle doit être libéré avec la fonction DsFreePasswordCredentials lorsqu’elle n’est plus nécessaire.
Valeur de retour
Retourne un code d’erreur Windows, y compris les éléments suivants.
Remarques
Un handle d’informations d’identification null, par défaut, est créé si utilisateur, domaine et mot de passe sont tous NULL. Sinon, utilisateur doit être présent. Le paramètre Domaine peut être NULL lorsque 'utilisateur est complet, tel qu’un utilisateur au format UPN ; par exemple, «someone@fabrikam.com».
Lorsque le handle retourné dans pAuthIdentity est passé à DsBindWithCred, DsUnBind doit être appelé avant de libérer le handle avec DsFreePasswordCredentials. La séquence normale est la suivante :
- Appelez DsMakePasswordCredentials pour obtenir le handle d’informations d’identification.
- Appelez DsBindWithCred et transmettez le handle d’informations d’identification.
- Appelez DsUnbind lorsque la liaison n’est plus nécessaire.
- Appelez DsFreePasswordCredentials pour libérer le handle d’informations d’identification.
Note
L’en-tête ntdsapi.h définit DsMakePasswordCredentials en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista |
| serveur minimum pris en charge | Windows Server 2008 |
| plateforme cible | Windows |
| d’en-tête | ntdsapi.h |
| bibliothèque | Ntdsapi.lib |
| DLL | Ntdsapi.dll |
Voir aussi
fonctions de gestion du contrôleur de domaine et de la réplication