CBaseDispatch.GetIDsOfNames-Methode

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

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 (Interface Identifier, 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 Parameter rgszNames übergebenen Namen entspricht.

Rückgabewert

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

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 soll. (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.

Anforderungen

Siehe auch

CBaseDispatch-Klasse