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

Weitere Informationen

ADSI-Fehlercodes

ADSI-Funktionen

ADsOpenObject

Bindung mit GetObject und ADsGetObject