IADsExtension::P rivateGetIDsOfNames-Methode (iads.h)

Artikel
08/24/2023

Die IADsExtension::P rivateGetIDsOfNames-Methode wird vom Aggregator ADSI aufgerufen, nachdem ADSI festgestellt hat, dass die Erweiterung zur Unterstützung einer Dual- oder Dispatch-Schnittstelle verwendet wird. Die -Methode kann die Typdaten verwenden, um DISPID mithilfe von IDispatch::GetIDsOfNames abzurufen.

Syntax

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

Parameter

riid

Für die zukünftige Verwendung reserviert. Es muss IID_NULL sein.

rgszNames

Das übergebene Array von zuzuordnenden Namen.

cNames

Die Anzahl der zuzuordnenden Namen.

lcid

Der Gebietsschemakontext, in dem die Namen interpretiert werden sollen.

rgDispid

Vom Aufrufer zugewiesenes Array, dessen jedes Element einen Bezeichner enthält, der einem der im Array rgszNames übergebenen Namen entspricht. Das erste Element stellt den Membernamen dar. Die nachfolgenden Elemente stellen die parameter des Elements dar.

Rückgabewert

Die Rückgabewerte sind mit denen der IDispatch::GetIDsOfNames-Standardmethode identisch. Weitere Informationen zu anderen Rückgabewerten finden Sie unter ADSI-Fehlercodes.

Hinweise

Alle Parameter haben die gleiche Bedeutung wie die entsprechenden Parameter in der Standard-IDispatch::GetIDsOfNames(). Die Erweiterungskomponente gibt einen eindeutigen Bezeichner (rgDispID) für jede Methode oder Eigenschaft zurück, die in den unterstützten dualen Schnittstellen definiert ist. Die Eindeutigkeit wird innerhalb der Erweiterungskomponente erzwungen. Der ADSI-Anbieter muss die Eindeutigkeit der DISPIDs aller Erweiterungsobjekte und des Aggregators (ADSI) selbst sicherstellen. Der rgDispID-Parameter muss zwischen 1 und 16777215 (2^24-1) oder -1 (DISPID_UNKNOWN) sein.

Beispiele

Das folgende C/C++-Codebeispiel zeigt eine generische Implementierung dieser Methode.

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);
}

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	iads.h
DLL	Activeds.dll