DsMakePasswordCredentialsA-Funktion (ntdsapi.h)

Die DsMakePasswordCredentials--Funktion erstellt einen Anmeldeinformationshandle, der für die Verwendung mit der DsBindWithCred-Funktion geeignet ist.

Syntax

NTDSAPI DWORD DsMakePasswordCredentialsA(
  [in]  LPCSTR                   User,
  [in]  LPCSTR                   Domain,
  [in]  LPCSTR                   Password,
  [out] RPC_AUTH_IDENTITY_HANDLE *pAuthIdentity
);

Parameter

[in] User

Zeigen Sie auf eine mit Null beendete Zeichenfolge, die den Benutzernamen enthält, der für die Anmeldeinformationen verwendet werden soll.

[in] Domain

Zeigen Sie auf eine mit Null beendete Zeichenfolge, die die Domäne enthält, in der der Benutzer Mitglied ist.

[in] Password

Zeigen Sie auf eine mit Null beendete Zeichenfolge, die das Kennwort enthält, das für die Anmeldeinformationen verwendet werden soll.

[out] pAuthIdentity

Zeigen Sie auf einen RPC_AUTH_IDENTITY_HANDLE Wert, der den Anmeldeinformationshandle empfängt. Dieses Handle wird in einem nachfolgenden Aufruf von DsBindWithCredverwendet. Dieses Handle muss mit der DsFreePasswordCredentials- Funktion freigegeben werden, wenn es nicht mehr erforderlich ist.

Rückgabewert

Gibt einen Windows-Fehlercode zurück, einschließlich der folgenden.

Bemerkungen

Ein Null-, Standardanmeldeinformationshandle wird erstellt, wenn Benutzer-, Domäne und Kennwort- alle NULL-sind. Andernfalls muss Benutzer- vorhanden sein. Der Parameter Domain kann NULL- sein, wenn Benutzer- voll qualifiziert ist, z. B. ein Benutzer im UPN-Format; beispiel: "someone@fabrikam.com".

Wenn das in pAuthIdentity- zurückgegebene Handle an DsBindWithCredübergeben wird, muss DsUnBind- aufgerufen werden, bevor der Handle mit DsFreePasswordCredentialsfreigegeben wird. Die normale Sequenz lautet:

1. Rufen Sie DsMakePasswordCredentials- auf, um den Anmeldeinformationshandle abzurufen.
2. Rufen Sie DsBindWithCredauf, und übergeben Sie den Anmeldeinformationshandle.
3. Rufen Sie DsUnbind- auf, wenn die Bindung nicht mehr erforderlich ist.
4. Rufen Sie DsFreePasswordCredentials- auf, um den Anmeldeinformationshandle frei zu geben.

Anforderungen

Siehe auch

Domänencontroller- und Replikationsverwaltungsfunktionen

DsBindWithCred

DsFreePasswordCredentials-

DsUnbind-

RPC_AUTH_IDENTITY_HANDLE