ChangeAccountPasswordA-Funktion (sspi.h)

Artikel
03/04/2024

Die ChangeAccountPassword-Funktion ändert das Kennwort für ein Windows-Domänenkonto mithilfe des angegebenen Sicherheitsunterstützungsanbieters.

Diese Funktion wird nur von den Anbietern Microsoft Kerberos, Microsoft Negotiate und Microsoft NTLM 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 aufrufende Prozess als Client ausgeführt wird; andernfalls FALSE.

[in] dwReserved

Reserviert. Muss auf 0 (null) festgelegt werden.

[in, out] pOutput

Bei der Eingabe ein Zeiger auf eine SecBufferDesc-Struktur . Die SecBufferDesc-Struktur muss einen einzelnen Puffer vom Typ SECBUFFER_CHANGE_PASS_RESPONSE enthalten. Bei der Ausgabe zeigt der pvBuffer-Member 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 Ausführung der Funktion fehlschlägt, wird ein Fehlercode zurückgegeben.

Hinweise

Hinweis

Der sspi.h-Header 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
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	sspi.h
Bibliothek	Secur32.lib
DLL	Secur32.dll

Freigeben über