ITypeLib::FindName

9/8/2008

Este método localiza ocorrências de uma descrição tipo em uma biblioteca tipo. Isso pode ser usado para verificar se existe um nome em uma biblioteca tipo.

Syntax

HRESULT FindName( 
  OLECHAR FAR* szNameBuf, 
  unsigned long lHashVal, 
  ITypeInfo FAR* FAR* ppTInfo, 
  MEMBERID FAR* rgMemId, 
  unsigned int FAR* pcFound 
); 

Parameters

• szNameBuf
  [in, Out] Seqüência de caracteres NULL-Terminated que contém o nome a pesquisa para.

• lHashVal
  [no] Valor para acelerar a pesquisa, computada pelo hash de LHashValOfNameSys função. Se lHashVal = 0, um valor é calculado.

• ppTInfo
  [out] Em retorno, uma matriz dos ponteiros para as descrições tipo que contém o nome especificado no szNameBuf. Não pode ser NULL.

• rgMemId
  [out] Matriz da MEMBERID elementos dos itens encontrados; rgMemId[i é o MEMBERID que indexa na descrição de tipo especificada por ppTInfo[i]. Não pode ser NULL.

• pcFound
  [in, Out] Na entrada, indica quantas instâncias para aspecto para. De exemplo *pcFound 1 = pode ser chamado para localizar a primeira ocorrência. A pesquisa pára quando um for encontrado.

  Em sair, indica o número de instâncias que foram encontradas. Se a pasta Em e Saída Valores de *pcFound São idêntico, pode haver mais descrições tipo que contém o nome.

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 gravar o arquivo.
TYPE_E_INVDATAREAD	A função não pôde ler a partir de arquivo.
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_CANTLOADLIBRARY	A biblioteca ou arquivo .DLL não pôde ser carregado.
TYPE_E_ELEMENTNOTFOUND	O elemento não foi encontrado.

Remarks

Passando *pcFound = n indica que há espaço suficiente na ppTInfo e rgMemId Matrizes para n (ptinfo, memid) pares. A função retorna MEMBERID_NIL in rgMemId[i, se o nome no szNameBuf é o nome de informações de tipo em ppTInfo[i].

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

See Also

Reference

ITypeLib
MEMBERID