Fungsi ADsGetObject (adshlp.h)

Artikel
22/08/2023

Fungsi ADsGetObject mengikat objek mengingat jalurnya dan pengidentifikasi antarmuka yang ditentukan.

Sintaks

HRESULT ADsGetObject(
  [in]  LPCWSTR lpszPathName,
  [in]  REFIID  riid,
  [out] VOID    **ppObject
);

Parameter

[in] lpszPathName

Jenis: LPCWSTR

String Unicode yang dihentikan null yang menentukan jalur yang digunakan untuk mengikat objek dalam layanan direktori yang mendasar. Untuk informasi selengkapnya dan contoh kode untuk mengikat string untuk parameter ini, lihat LDAP ADsPath dan WinNT ADsPath.

[in] riid

Jenis: REFIID

Pengidentifikasi antarmuka untuk antarmuka tertentu pada objek ini.

[out] ppObject

Jenis: VOID**

Arahkan ke penunjuk ke Antarmuka yang diminta.

Menampilkan nilai

Jenis: HRESULT

Metode ini mendukung nilai pengembalian HRESULT standar, serta yang berikut ini.

Untuk informasi selengkapnya tentang nilai pengembalian lainnya, lihat Kode Kesalahan ADSI.

Keterangan

Klien C/C++ memanggil fungsi pembantu ADsGetObject untuk mengikat objek ADSI. Ini setara dengan klien Visual Basic yang memanggil fungsi GetObject . Keduanya mengambil ADsPath sebagai input dan mengembalikan pointer ke antarmuka yang diminta. Secara default pengikatan menggunakan opsi ADS_SECURE_AUTHENTICATION dengan konteks keamanan utas panggilan. Namun, jika autentikasi gagal, ikatan aman diturunkan ke ikatan anonim, misalnya, ikatan sederhana tanpa kredensial pengguna. Untuk mengikat objek ADSI dengan aman, gunakan fungsi ADsOpenObject alih-alih fungsi ADsGetObject .

Untuk contoh kode yang menunjukkan cara menggunakan ADsOpenObject, lihat Mengikat Dengan GetObject dan ADsGetObject.

Dimungkinkan untuk mengikat objek ADSI dengan kredensial pengguna yang berbeda dari pengguna yang saat ini masuk. Untuk melakukan operasi ini, gunakan fungsi ADsOpenObject .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	adshlp.h
Pustaka	Activeds.lib
DLL	Activeds.dll