Compartir a través de

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

  • Artículo

Recupera la variable con el identificador de miembro especificado o el nombre de la propiedad o el método y los parámetros que corresponden al identificador de función especificado.

Sintaxis

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

Parámetros

[in] memid

Identificador del miembro cuyo nombre o nombres se van a devolver.

[out] rgBstrNames

Matriz asignada por el autor de la llamada. Al devolver, cada uno de los elementos contiene el nombre (o nombres) asociado al miembro.

[in] cMaxNames

Longitud de la matriz rgBstrNames pasada.

[out] pcNames

Número de nombres de la matriz rgBstrNames .

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
Correcto.
E_INVALIDARG
Uno o varios de los argumentos no son válidos.
E_OUTOFMEMORY
Memoria insuficiente para completar la operación.

Comentarios

El llamador debe liberar la matriz BSTR devuelta.

Si el identificador de miembro identifica una propiedad que se implementa con funciones de propiedad, se devuelve el nombre de la propiedad. Para las funciones get de propiedades, siempre se devuelven los nombres de la función y sus parámetros.

Para las funciones de referencia put y put, el lado derecho de la asignación no tiene nombre. Si cMaxNames es menor que es necesario para devolver todos los nombres de los parámetros de una función, solo se devuelven los nombres de los primeros parámetros cMaxNames - 1. Los nombres de los parámetros se devuelven en la matriz en el mismo orden en que aparecen en otra parte de la interfaz (por ejemplo, el mismo orden en la matriz de parámetros asociada a la enumeración FUNCDESC).

Si la descripción del tipo hereda de otra descripción de tipo, esta función es recursiva a la descripción del tipo base, si es necesario, para buscar el elemento con el identificador de miembro solicitado.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado oaidl.h

Consulte también

Itypeinfo