ChangeAccountPasswordA-Funktion (sspi.h)

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

Anforderungen