ChangeAccountPasswordA-Funktion (sspi.h)

Artikel
11/20/2024

Die ChangeAccountPassword Funktion ändert das Kennwort für ein Windows-Domänenkonto mithilfe des angegebenen Security Support Provider.

Diese Funktion wird nur von den Microsoft Kerberos, Microsoft Negotiateund Microsoft NTLM-Anbieter unterstützt.

Syntax

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
);

Parameter

[in] pszPackageName

Der Name des zu verwendenden Anbieters. Der Wert dieses Parameters muss entweder "Kerberos", "Negotiate" oder "NTLM" sein.

[in] pszDomainName

Die Domäne des Kontos, für das das Kennwort geändert werden soll.

[in] pszAccountName

Der Benutzername des Kontos, für das das Kennwort geändert werden soll.

[in] pszOldPassword

Das alte Kennwort, das geändert werden soll.

[in] pszNewPassword

Das neue Kennwort für das angegebene Konto.

[in] bImpersonating

TRUE, wenn der Aufrufvorgang als Client ausgeführt wird; andernfalls FALSE.

[in] dwReserved

Reserviert. Muss auf Null festgelegt werden.

[in, out] pOutput

Bei Eingaben zeigt ein Zeiger auf eine SecBufferDesc- Struktur. Die SecBufferDesc--Struktur muss einen einzelnen Puffer vom Typ SECBUFFER_CHANGE_PASS_RESPONSEenthalten. Bei der Ausgabe verweist das pvBuffer Mitglied dieser Struktur auf eine DOMAIN_PASSWORD_INFORMATION Struktur.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion SEC_E_OK zurück.

Wenn die Funktion fehlschlägt, wird ein Fehlercode zurückgegeben.

Bemerkungen

Anmerkung

Der Header "sspi.h" definiert ChangeAccountPassword als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2008 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	sspi.h
Library	Secur32.lib
DLL-	Secur32.dll

Freigeben über