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 |
---|---|
|
Operazione completata. |
|
Memoria insufficiente. |
|
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 |
|
Libreria |
|