CBaseDispatch.GetIDsOfNames-Methode

Die GetIDsOfNames -Methode ordnet einen Satz von Namen einem entsprechenden Satz von DISPIDs zu.

Syntax

HRESULT GetIDsOfNames(
   REFIID  riid,
   OLECHAR **rgszNames,
   UINT    cNames,
   LCID    lcid,
   DISPID  *rgdispid
);

Parameter

riid

Verweis auf einen Schnittstellenbezeichner (IID), der die Schnittstelle angibt.

rgszNames

Adresse eines Arrays von Breitzeichenzeichenfolgen, die die zuzuordnenden Namen enthalten.

cNames

Größe des Arrays, das vom rgszNames-Parameter angegeben wird.

lcid

Gebietsschemakontext, in dem die Namen interpretiert werden sollen. Kann NULL sein.

rgdispid

Zeiger auf ein Array, das die DISPIDs empfängt. Jedes Element von empfängt einen Bezeichner, der einem der im rgszNames-Parameter übergebenen Namen entspricht.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Die folgenden Werte sind möglich.

Rückgabecode Beschreibung
S _ OK
Erfolg.
E _ OUTOFMEMORY
Nicht genügend Arbeitsspeicher.
DISP _ E _ UNKNOWNNAME
Mindestens ein Name war nicht bekannt.

Bemerkungen

Diese Methode verhält sich wie die IDispatch::GetIDsOfNames-Methode, aber der riid-Parameter gibt die Schnittstelle an, für die DISPIDs abgerufen werden sollen. (In der IDispatch-Version ist der riid-Parameter reserviert.)

Wenn die Methode DISP _ E _ UNKNOWNNAME zurückgibt, enthalten die zurückgegebenen DISPIDs DISPID UNKNOWN für jeden Eintrag, der _ einem unbekannten Namen entspricht.

Requirements (Anforderungen)

Anforderung Wert
Header
Ctlutil.h (include Streams.h)
Bibliothek
Strmbase.lib (Verkaufsbuilds);
Strmbasd.lib (Debugbuilds)

Weitere Informationen

CBaseDispatch-Klasse