DsMakePasswordCredentialsA-Funktion (ntdsapi.h)

  • Artikel

Die DsMakePasswordCredentials-Funktion erstellt ein Anmeldeinformationshandle, das 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

Zeiger auf eine NULL-Zeichenfolge, die den Benutzernamen enthält, der für die Anmeldeinformationen verwendet werden soll.

[in] Domain

Zeiger auf eine null-beendete Zeichenfolge, die die Domäne enthält, der der Benutzer angehört.

[in] Password

Zeiger auf eine null-beendete Zeichenfolge, die das Kennwort enthält, das für die Anmeldeinformationen verwendet werden soll.

[out] pAuthIdentity

Zeiger auf einen RPC_AUTH_IDENTITY_HANDLE Wert, der das Anmeldeinformationshandle empfängt. Dieses Handle wird in einem nachfolgenden Aufruf von DsBindWithCred verwendet. 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 des folgenden.

Hinweise

Ein Null-Standardhandle für Anmeldeinformationen wird erstellt, wenn Benutzer, Domäne und Kennwortalle NULL sind. Andernfalls muss der Benutzer anwesend sein. Der Parameter Domain kann NULL sein, wenn der 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 das Handle mit DsFreePasswordCredentials freigegeben wird. Die normale Sequenz ist:

  1. Rufen Sie DsMakePasswordCredentials auf , um das Handle der Anmeldeinformationen abzurufen.
  2. Rufen Sie DsBindWithCred auf, und übergeben Sie das Handle der Anmeldeinformationen.
  3. Rufen Sie DsUnbind auf , wenn die Bindung nicht mehr erforderlich ist.
  4. Rufen Sie DsFreePasswordCredentials auf , um das Handle der Anmeldeinformationen frei zu geben.

Hinweis

Der ntdsapi.h-Header definiert DsMakePasswordCredentials als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code 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
Unterstützte Mindestversion (Server) Windows Server 2008
Zielplattform Windows
Kopfzeile ntdsapi.h
Bibliothek Ntdsapi.lib
DLL Ntdsapi.dll

Weitere Informationen

Domänencontroller und Replikationsverwaltungsfunktionen

DsBindWithCred

DsFreePasswordCredentials

DsUnbind

RPC_AUTH_IDENTITY_HANDLE