Méthode CBaseDispatch.GetIDsOfNames

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La GetIDsOfNames méthode mappe un ensemble de noms à un ensemble correspondant de DISPID.

Syntaxe

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

Paramètres

riid

Référence à un identificateur d’interface (IID) qui spécifie l’interface.

rgszNames

Adresse d’un tableau de chaînes à caractères larges qui contiennent les noms à mapper.

cNames

Taille du tableau donné par le paramètre rgszNames .

lcid

Contexte de paramètres régionaux dans lequel interpréter les noms. Peut être NULL.

rgdispid

Pointeur vers un tableau qui reçoit les DISPID. Chaque élément de reçoit un identificateur qui correspond à l’un des noms passés dans le paramètre rgszNames .

Valeur renvoyée

Retourne une valeur HRESULT . Les valeurs possibles sont les suivantes.

Code de retour Description
S_OK
Opération réussie.
E_OUTOFMEMORY
Mémoire insuffisante.
DISP_E_UNKNOWNNAME
Un ou plusieurs des noms n’étaient pas connus.

Notes

Cette méthode se comporte comme la méthode IDispatch::GetIDsOfNames , mais le paramètre riid spécifie l’interface sur laquelle récupérer les DISPID. (Dans la version IDispatch , le paramètre riid est réservé.)

Si la méthode retourne DISP_E_UNKNOWNNAME, les DISPID retournés contiennent DISPID_UNKNOWN pour chaque entrée qui correspond à un nom inconnu.

Configuration requise

Condition requise Valeur
En-tête
Ctlutil.h (include Streams.h)
Bibliothèque
Strmbase.lib (builds de vente au détail) ;
Strmbasd.lib (builds de débogage)

Voir aussi

CBaseDispatch, classe