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 |
|---|---|
|
Opération réussie. |
|
Mémoire insuffisante. |
|
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 |
|
| Bibliothèque |
|