DsBindWithCredA-Funktion (ntdsapi.h)
Die DsBindWithCred-Funktion bindet mit den 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 NULL-beendete Zeichenfolge, die den vollqualifizierten DNS-Namen der zu bindenden Domäne enthält. Weitere Informationen zu diesem Parameter finden Sie in der DomainControllerName-Beschreibung im Thema DsBind .
[in, optional] DnsDomainName
Zeiger auf eine NULL-Zeichenfolge, die den vollqualifizierten DNS-Namen der Domäne enthält, an die gebunden 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 schützen.
[in, optional] AuthIdentity
Enthält einen RPC_AUTH_IDENTITY_HANDLE Wert, der die Anmeldeinformationen darstellt, die für die Bindung verwendet werden sollen. The
Die 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 erfolgreich oder ein Windows- oder RPC-Fehlercode andernfalls. Im Folgenden finden Sie die häufigsten Fehlercodes.
Hinweise
Hinweis
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 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 |