ADsGetObject-Funktion (adshlp.h)
Die ADsGetObject-Funktion bindet an ein Objekt unter Berücksichtigung des Pfads und eines angegebenen Schnittstellenbezeichners.
Syntax
HRESULT ADsGetObject(
[in] LPCWSTR lpszPathName,
[in] REFIID riid,
[out] VOID **ppObject
);
Parameter
[in] lpszPathName
Typ: LPCWSTR
Die Unicode-Zeichenfolge mit Null-Beendigung, die den Pfad angibt, der zum Binden an das Objekt im zugrunde liegenden Verzeichnisdienst verwendet wird. Weitere Informationen und Codebeispiele für Bindungszeichenfolgen für diesen Parameter finden Sie unter LDAP ADsPath und WinNT ADsPath.
[in] riid
Typ: REFIID
Schnittstellenbezeichner für eine angegebene Schnittstelle für dieses Objekt.
[out] ppObject
Typ: VOID**
Zeiger auf einen Zeiger auf die angeforderte Schnittstelle.
Rückgabewert
Typ: HRESULT
Diese Methode unterstützt die HRESULT-Standardrückgabewerte sowie folgendes.
Weitere Informationen zu anderen Rückgabewerten finden Sie unter ADSI-Fehlercodes.
Hinweise
Ein C/C++-Client ruft die Hilfsfunktion ADsGetObject auf, um an ein ADSI-Objekt zu binden. Es entspricht einem Visual Basic-Client, der die GetObject-Funktion aufruft . Beide verwenden einen ADsPath als Eingabe und geben einen Zeiger auf die angeforderte Schnittstelle zurück. Standardmäßig verwendet die Bindung ADS_SECURE_AUTHENTICATION Option mit dem Sicherheitskontext des aufrufenden Threads. Wenn die Authentifizierung jedoch fehlschlägt, wird die sichere Bindung auf eine anonyme Bindung heruntergestuft, z. B. eine einfache Bindung ohne Benutzeranmeldeinformationen. Verwenden Sie zum sicheren Binden an ein ADSI-Objekt die Funktion ADsOpenObject anstelle der Funktion ADsGetObject .
Ein Codebeispiel, das zeigt, wie ADsOpenObject verwendet wird, finden Sie unter Bindung mit GetObject und ADsGetObject.
Es ist möglich, eine Bindung an ein ADSI-Objekt mit anderen Benutzeranmeldeinformationen als dem aktuell angemeldeten Benutzer zu erstellen. Verwenden Sie zum Ausführen dieses Vorgangs die Funktion ADsOpenObject .
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | adshlp.h |
| Bibliothek | Activeds.lib |
| DLL | Activeds.dll |