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:
- Rufen Sie DsMakePasswordCredentials- auf, um den Anmeldeinformationshandle abzurufen.
- Rufen Sie DsBindWithCredauf, und übergeben Sie den Anmeldeinformationshandle.
- Rufen Sie DsUnbind- auf, wenn die Bindung nicht mehr erforderlich ist.
- Rufen Sie DsFreePasswordCredentials- auf, um den Anmeldeinformationshandle frei zu geben.
Anmerkung
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 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 |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| mindestens unterstützte Server- | Windows Server 2008 |
| Zielplattform- | Fenster |
| Header- | ntdsapi.h |
| Library | Ntdsapi.lib |
| DLL- | Ntdsapi.dll |