DsBindWithCredA-Funktion (ntdsapi.h)
Die DsBindWithCred-Funktion bindet mithilfe der angegebenen Anmeldeinformationen an einen Domänencontroller.
Syntax
NTDSAPI DWORD DsBindWithCredA(
[in, optional] LPCSTR DomainControllerName,
[in, optional] LPCSTR DnsDomainName,
[in, optional] RPC_AUTH_IDENTITY_HANDLE AuthIdentity,
[out] HANDLE *phDS
);
Parameter
[in, optional] DomainControllerName
Zeiger auf eine mit Null beendete Zeichenfolge, die den vollqualifizierten DNS-Namen der Domäne enthält, die gebunden werden soll. Weitere Informationen zu diesem Parameter finden Sie in der beschreibung DomainControllerName im thema DsBind.
[in, optional] DnsDomainName
Zeiger auf eine mit Null beendete Zeichenfolge, die den vollqualifizierten DNS-Namen der Domäne enthält, an die eine Bindung hergestellt werden soll. Weitere Informationen zu diesem Parameter finden Sie in der beschreibung DnsDomainName im Thema DsBind.
Dieser Parameter ist erforderlich, um eine Kerberos-Authentifizierung zu sichern.
[in, optional] AuthIdentity
Enthält einen RPC_AUTH_IDENTITY_HANDLE Wert, der die Anmeldeinformationen darstellt, die für die Bindung verwendet werden sollen. Das
DsMakePasswordCredentials Funktion wird verwendet, um diesen Wert abzurufen. Wenn dieser Parameter NULL-ist, werden die Anmeldeinformationen des aufrufenden Threads verwendet.
DsUnBind- muss aufgerufen werden, bevor dieses Handle mit der DsFreePasswordCredentials--Funktion freigegeben wird.
[out] phDS
Adresse eines HANDLE Werts, der das Bindungshandle empfängt. Um dieses Handle zu schließen, übergeben Sie es an die DsUnBind--Funktion.
Rückgabewert
Gibt ERROR_SUCCESS zurück, wenn ein Windows- oder RPC-Fehlercode andernfalls erfolgreich war. Im Folgenden finden Sie die am häufigsten verwendeten Fehlercodes.
Bemerkungen
Anmerkung
Der ntdsapi.h-Header definiert DsBindWithCred als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch 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 |