IADsExtension::P rivateGetIDsOfNames method (iads.h)

  • Artikel

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.

Sintaks

HRESULT PrivateGetIDsOfNames(
  REFIID       riid,
  OLECHAR      **rgszNames,
  unsigned int cNames,
  LCID         lcid,
  DISPID       *rgDispid
);

Parameter

riid

Disiapkan untuk penggunaan masa mendatang. Pasti IID_NULL.

rgszNames

Array nama yang diteruskan untuk dipetakan.

cNames

Hitungan nama yang akan dipetakan.

lcid

Konteks lokal untuk menginterpretasikan nama.

rgDispid

Array yang dialokasikan pemanggil, setiap elemen berisi pengidentifikasi yang sesuai dengan salah satu nama yang diteruskan dalam array rgszNames . Elemen pertama mewakili nama anggota. Elemen berikutnya mewakili setiap parameter anggota.

Nilai kembali

Nilai yang dikembalikan sama dengan nilai metode IDispatch::GetIDsOfNames standar. Untuk informasi selengkapnya tentang nilai pengembalian lainnya, lihat Kode Kesalahan ADSI.

Keterangan

Semua parameter memiliki arti yang sama dengan yang sesuai dalam IDispatch standar::GetIDsOfNames(). Komponen ekstensi mengembalikan pengidentifikasi unik (rgDispID) untuk setiap metode atau properti yang ditentukan dalam antarmuka ganda yang didukung. Keunikan diberlakukan dalam komponen ekstensi. Penyedia ADSI harus memastikan keunikan DISPID dari semua objek ekstensi dan agregator (ADSI) itu sendiri. Parameter rgDispID harus antara 1 dan 16777215 (2^24-1), atau -1 (DISPID_UNKNOWN).

Contoh

Contoh kode C/C++ berikut menunjukkan implementasi generik dari metode ini.

STDMETHOD(PrivateGetIDsOfNames)(REFIID riid, OLECHAR ** rgszNames, unsigned int cNames, LCID lcid, DISPID  * rgdispid)
{
  if (rgdispid == NULL)
  {
     return E_POINTER;
  }
  return  DispGetIDsOfNames(m_pTypeInfo, rgszNames, cNames, rgdispid);
}

Persyaratan

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

Lihat juga

Kode Kesalahan ADSI

IADsExtension

IADsExtension::P rivateInvoke

IDispatch::GetIDsOfNames