Bagikan melalui

Antarmuka IADsExtension (iads.h)

  • Artikel

Antarmuka IADsExtension membentuk dasar model ekstensi aplikasi ADSI. Ini memungkinkan vendor perangkat lunak independen (ISV) untuk menambahkan perilaku khusus aplikasi, seperti metode atau fungsi, ke dalam objek ADSI yang ada. Beberapa vendor dapat secara independen memperluas fitur objek yang sama untuk melakukan operasi serupa, tetapi tidak terkait.

Model ekstensi didasarkan pada model agregasi di COM. Agregator, atau objek luar, dapat ditambahkan ke dasar metodenya, objek agregat, atau objek dalamnya. Objek ekstensi ADSI, yang mengimplementasikan antarmuka IADsExtension , adalah objek agregat, sedangkan penyedia ADSI adalah agregator.

Catatan Saat menerapkan modul ekstensi, rilis antarmuka setelah selesai. Jika tidak, agregator tidak dapat melepaskan antarmuka bahkan ketika tidak lagi diperlukan.
 
Antarmuka IADsExtension dapat digunakan sebagai berikut:
  • Komponen ekstensi memerlukan pemberitahuan inisialisasi seperti yang didefinisikan oleh dwCode dalam metode Operasi . Dalam hal ini, klien ekstensi harus memanggil metode Operasi . Dua metode lainnya, yaitu, PrivateInvoke dan PrivateGetIDsOfNames, biasanya mengembalikan E_NOTIMPL dalam nilai HRESULT .
  • Komponen ekstensi mendukung antarmuka ganda atau pengiriman apa pun. Dalam hal ini, klien ekstensi harus memanggil metode PrivateGetIDsOfNames atau PrivateInvoke . Operasi biasanya mengabaikan data dan mengembalikan E_NOTIMPL dalam nilai HRESULT .

Warisan

Antarmuka IADsExtension mewarisi dari antarmuka IUnknown . IADsExtension juga memiliki jenis anggota ini:

Metode

Antarmuka IADsExtension memiliki metode ini.

 
IADsExtension::Operate

Menafsirkan kode kontrol dan parameter input sesuai dengan spesifikasi penyedia.
IADsExtension::P rivateGetIDsOfNames

Metode IADsExtension::P rivateGetIDsOfNames dipanggil oleh agregator, ADSI, setelah ADSI menentukan bahwa ekstensi digunakan untuk mendukung antarmuka ganda atau pengiriman. Metode ini dapat menggunakan data jenis untuk mendapatkan DISPID menggunakan IDispatch::GetIDsOfNames.
IADsExtension::P rivateInvoke

Metode IADsExtension::P rivateInvoke biasanya dipanggil oleh ADSI setelah metode IADsExtension::P rivateGetIDsOfNames. Metode ini dapat memiliki implementasi kustom atau dapat mendelegasikan operasi ke metode IDispatch::D ispInvoke.

Persyaratan

   
Klien minimum yang didukung Windows Vista
Server minimum yang didukung Windows Server 2008
Target Platform Windows
Header iads.h