Partager via


ChangeAccountPasswordA, fonction (sspi.h)

La fonction ChangeAccountPassword modifie le mot de passe d’un compte de domaine Windows à l’aide du fournisseur de support de sécurité spécifié.

Cette fonction est prise en charge uniquement par les fournisseurs Microsoft Kerberos, Microsoft Negotiate et Microsoft NTLM .

Syntaxe

SECURITY_STATUS SEC_ENTRY ChangeAccountPasswordA(
  [in]      SEC_CHAR       *pszPackageName,
  [in]      SEC_CHAR       *pszDomainName,
  [in]      SEC_CHAR       *pszAccountName,
  [in]      SEC_CHAR       *pszOldPassword,
  [in]      SEC_CHAR       *pszNewPassword,
  [in]      BOOLEAN        bImpersonating,
  [in]      unsigned long  dwReserved,
  [in, out] PSecBufferDesc pOutput
);

Paramètres

[in] pszPackageName

Nom du fournisseur à utiliser. La valeur de ce paramètre doit être « Kerberos », « Negotiate » ou « NTLM ».

[in] pszDomainName

Domaine du compte pour lequel modifier le mot de passe.

[in] pszAccountName

Nom d’utilisateur du compte pour lequel modifier le mot de passe.

[in] pszOldPassword

Ancien mot de passe à modifier.

[in] pszNewPassword

Nouveau mot de passe pour le compte spécifié.

[in] bImpersonating

TRUE si le processus appelant s’exécute en tant que client ; sinon, FALSE.

[in] dwReserved

Réservé. Doit être défini sur zéro.

[in, out] pOutput

Lors de l’entrée, pointeur vers une structure SecBufferDesc . La structure SecBufferDesc doit contenir une seule mémoire tampon de type SECBUFFER_CHANGE_PASS_RESPONSE. À la sortie, le membre pvBuffer de cette structure pointe vers une structure DOMAIN_PASSWORD_INFORMATION .

Valeur retournée

Si la fonction réussit, la fonction retourne SEC_E_OK.

Si la fonction échoue, elle retourne un code d'erreur.

Remarques

Notes

L’en-tête sspi.h définit ChangeAccountPassword comme 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 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête sspi.h
Bibliothèque Secur32.lib
DLL Secur32.dll