DsMakePasswordCredentialsA-Funktion (ntdsapi.h)
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:
- Rufen Sie DsMakePasswordCredentials auf , um das Handle der Anmeldeinformationen abzurufen.
- Rufen Sie DsBindWithCred auf, und übergeben Sie das Handle der Anmeldeinformationen.
- Rufen Sie DsUnbind auf , wenn die Bindung nicht mehr erforderlich ist.
- 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 |