DsMakePasswordCredentialsA, fonction (ntdsapi.h)
La fonction DsMakePasswordCredentials construit un handle d’informations d’identification utilisable avec la fonction DsBindWithCred .
Syntaxe
NTDSAPI DWORD DsMakePasswordCredentialsA(
[in] LPCSTR User,
[in] LPCSTR Domain,
[in] LPCSTR 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 quand elle n’est plus nécessaire.
Valeur retournée
Retourne un code d’erreur Windows, y compris les éléments suivants.
Remarques
Un handle d’informations d’identification par défaut null est créé si l’utilisateur, le domaine et le mot de passe sont tous NULL. Sinon, l’utilisateur doit être présent. Le paramètre Domain peut être NULL lorsque l’utilisateur est complet, par exemple 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 passez 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.
Notes
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. La combinaison 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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | ntdsapi.h |
| Bibliothèque | Ntdsapi.lib |
| DLL | Ntdsapi.dll |
Voir aussi
Fonctions de gestion des contrôleurs de domaine et de la réplication