ChangeAccountPasswordA, fonction (sspi.h)

Article
08/26/2023

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

Partager via