ITypeInfo::GetNames
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Este método recupera a variável com o identificador especificado membro, ou o nome dos nomes de função e parâmetro correspondente para o identificador função especificada.
Syntax
HRESULT GetNames(
MEMBERID memid,
BSTR FAR* rgBstrNames,
unsigned int cMaxNames,
unsigned int FAR* pcNames
);
Parameters
- memid
[no] Identificador do membro cujo nome (ou nomes) é a ser retornado.
- rgBstrNames
[out] Ponteiro para a matriz Caller-allocated. Em retorno, cada um desses lpcName Elementos é preenchido para apontar para um BSTR que contém o nome (ou nomes) associado com o membro.
- cMaxNames
[no] Comprimento do passado- rgBstrNames matriz.
- pcNames
[out] Em retorno, ponteiro para o número que representa o número de nomes em rgBstrNames matriz.
Return Value
A seguinte tabela mostra os valores de retorno para esta função.
| Valor | Descrição |
|---|---|
S_OK |
O sucesso. |
E_OUTOFMEMORY |
Memória insuficiente. |
E_INVALIDARG |
Um ou mais dos parâmetros é inválido. |
TYPE_E_IOERROR |
A função não pôde ler a partir de arquivo. |
TYPE_E_INVDATAREAD |
Dados inválidos. |
TYPE_E_UNSUPFORMAT |
A biblioteca tipo tem um formato mais antigo. |
TYPE_E_INVALIDSTATE |
Não foi possível abrir a biblioteca tipo. |
TYPE_E_WRONGTYPEKIND |
Tipo incompatível. |
TYPE_E_ELEMENTNOTFOUND |
O elemento não foi encontrado. |
Remarks
O chamador deve versão o retornado BSTR matriz.
Se o identificador membro identifica uma propriedade que é implementada com funções propriedade, o propriedade nome será retornado.
De propriedade get funções, os nomes da função e seus parâmetros sempre são retornados.
Para propriedade pôr e pôr referência funções, o direito lado do atribuída é sem nome.
Se cMaxNames é menor do que é exigido para retornar todos os nomes de parâmetros de uma função, somente os nomes da primeira cMaxNames Parâmetros – 1 são retornados.
Os nomes dos parâmetros são retornados na matriz na mesma ordem em que aparecem em qualquer lugar na interface (de exemplo, a mesma ordem na matriz de parâmetro associado com o FUNCDESC enumeração).
Se a descrição tipo herda descrição outro tipo, essa função é recursivo para a descrição tipo base, se necessário, para localizar o item com o identificador membro solicitado.
Requirements
| Header | oaidl.h, oaidl.idl |
| Library | oleaut32.lib, uuid.lib |
| Windows Embedded CE | Windows CE 2.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |