Méthode ITypeInfo ::GetNames (oaidl.h)

Article
03/04/2024

Récupère la variable avec l’ID de membre spécifié ou le nom de la propriété ou de la méthode et les paramètres qui correspondent à l’ID de fonction spécifié.

Syntaxe

HRESULT GetNames(
  [in]  MEMBERID memid,
  [out] BSTR     *rgBstrNames,
  [in]  UINT     cMaxNames,
  [out] UINT     *pcNames
);

Paramètres

[in] memid

ID du membre dont le nom (ou les noms) doit être retourné.

[out] rgBstrNames

Tableau alloué par l’appelant. Au retour, chacun des éléments contient le nom (ou les noms) associés au membre.

[in] cMaxNames

Longueur du tableau rgBstrNames transmis.

[out] pcNames

Nombre de noms dans le tableau rgBstrNames .

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour	Description
S_OK	Réussite.
E_INVALIDARG	Un ou plusieurs arguments ne sont pas valides.
E_OUTOFMEMORY	Mémoire insuffisante pour terminer l’opération.

Remarques

L’appelant doit libérer le tableau BSTR retourné.

Si l’ID de membre identifie une propriété implémentée avec des fonctions de propriété, le nom de la propriété est retourné. Pour les fonctions get de propriété, les noms de la fonction et ses paramètres sont toujours retournés.

Pour les fonctions de référence de propriété put et put, le côté droit de l’affectation n’est pas nommé. Si cMaxNames est inférieur à est requis pour retourner tous les noms des paramètres d’une fonction, seuls les noms des premiers paramètres cMaxNames - 1 sont retournés. Les noms des paramètres sont retournés dans le tableau dans le même ordre qu’ils apparaissent ailleurs dans l’interface (par exemple, le même ordre dans le tableau de paramètres associé à l’énumération FUNCDESC).

Si la description de type hérite d’une autre description de type, cette fonction est récursive à la description du type de base, si nécessaire, pour rechercher l’élément avec l’ID de membre demandé.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	oaidl.h

Voir aussi

ITypeInfo

Partager via