Metodo CBaseDispatch.GetIDsOfNames

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il GetIDsOfNames metodo esegue il mapping di un set di nomi a un set corrispondente di DISPID.

Sintassi

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

Parametri

riid

Riferimento a un identificatore di interfaccia (IID) che specifica l'interfaccia.

rgszNames

Indirizzo di una matrice di stringhe di caratteri wide che contengono i nomi da eseguire il mapping.

cNames

Dimensioni della matrice specificata dal parametro rgszNames .

lcid

Contesto delle impostazioni locali in cui interpretare i nomi. Può essere NULL.

rgdispid

Puntatore a una matrice che riceve i DISPID. Ogni elemento di riceve un identificatore che corrisponde a uno dei nomi passati nel parametro rgszNames .

Valore restituito

Restituisce un valore HRESULT . Di seguito sono indicati alcuni valori possibili.

Codice restituito Descrizione
S_OK
Operazione completata.
E_OUTOFMEMORY
Memoria insufficiente.
DISP_E_UNKNOWNNAME
Uno o più nomi non erano noti.

Commenti

Questo metodo si comporta come il metodo IDispatch::GetIDsOfNames , ma il parametro riid specifica l'interfaccia in cui recuperare DISPID. Nella versione IDispatch il parametro riid è riservato.

Se il metodo restituisce DISP_E_UNKNOWNNAME, i DISPID restituiti contengono DISPID_UNKNOWN per ogni voce corrispondente a un nome sconosciuto.

Requisiti

Requisito Valore
Intestazione
Ctlutil.h (includere Streams.h)
Libreria
Strmbase.lib (build al dettaglio);
Strmbasd.lib (build di debug)

Vedi anche

Classe CBaseDispatch