ChangeAccountPasswordW, fonction (sspi.h)

Article
11/20/2024

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 lesMicrosoft Kerberos , Microsoft Negotiateet fournisseurs de Microsoft NTLM.

Syntaxe

SECURITY_STATUS SEC_ENTRY ChangeAccountPasswordW(
  [in]      SEC_WCHAR      *pszPackageName,
  [in]      SEC_WCHAR      *pszDomainName,
  [in]      SEC_WCHAR      *pszAccountName,
  [in]      SEC_WCHAR      *pszOldPassword,
  [in]      SEC_WCHAR      *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, un pointeur vers une structure SecBufferDesc . La structure SecBufferDesc doit contenir une seule mémoire tampon de type SECBUFFER_CHANGE_PASS_RESPONSE. En sortie, le pvBuffer membre de cette structure pointe vers une structure DOMAIN_PASSWORD_INFORMATION.

Valeur de retour

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

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

Remarques

Note

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. 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 [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2008 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	sspi.h
bibliothèque	Secur32.lib
DLL	Secur32.dll

Partager via