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.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Erfolg. |
|
Nicht genügend Arbeitsspeicher. |
|
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 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
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|