Share via

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

  • Artigo

Recupera a variável com a ID de membro especificada ou o nome da propriedade ou método e os parâmetros que correspondem à ID da função especificada.

Sintaxe

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

Parâmetros

[in] memid

A ID do membro cujo nome (ou nomes) é retornado.

[out] rgBstrNames

A matriz alocada pelo chamador. No retorno, cada um dos elementos contém o nome (ou nomes) associados ao membro.

[in] cMaxNames

O comprimento da matriz rgBstrNames passada.

[out] pcNames

O número de nomes na matriz rgBstrNames .

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
Êxito.
E_INVALIDARG
Um ou mais argumentos não são válidos.
E_OUTOFMEMORY
Memória insuficiente para concluir a operação.

Comentários

O chamador deve liberar a matriz BSTR retornada.

Se a ID do membro identificar uma propriedade implementada com funções de propriedade, o nome da propriedade será retornado. Para funções de obtenção de propriedade, os nomes da função e seus parâmetros são sempre retornados.

Para funções de referência de colocação e colocação de propriedade, o lado direito da atribuição não tem nome. Se cMaxNames for menor do que é necessário para retornar todos os nomes dos parâmetros de uma função, somente os nomes dos primeiros parâmetros cMaxNames - 1 serão retornados. Os nomes dos parâmetros são retornados na matriz na mesma ordem em que aparecem em outro lugar na interface (por exemplo, a mesma ordem na matriz de parâmetros associada à enumeração FUNCDESC).

Se a descrição do tipo herdar de outra descrição de tipo, essa função será recursiva à descrição do tipo base, se necessário, para localizar o item com a ID de membro solicitada.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho oaidl.h

Confira também

ITypeInfo