Método ITypeLib::FindName (oaidl.h)

  • Artigo

Localiza as ocorrências de uma descrição de tipo em uma biblioteca de tipos. Isso pode ser usado para verificar rapidamente se existe um nome em uma biblioteca de tipos.

Sintaxe

HRESULT FindName(
  [in, out] LPOLESTR  szNameBuf,
  [in]      ULONG     lHashVal,
  [out]     ITypeInfo **ppTInfo,
  [out]     MEMBERID  *rgMemId,
  [in, out] USHORT    *pcFound
);

Parâmetros

[in, out] szNameBuf

O nome a ser procurado.

[in] lHashVal

Um valor de hash para acelerar a pesquisa, calculado pela função LHashValOfNameSys . Se lHashVal = 0, um valor será calculado.

[out] ppTInfo

Uma matriz de ponteiros para as descrições de tipo que contêm o nome especificado em szNameBuf. Esse parâmetro não pode ser nulo.

[out] rgMemId

Uma matriz dos itens encontrados; rgMemId[i] é o MEMBERID que indexa na descrição do tipo especificada por ppTInfo[i]. Esse parâmetro não pode ser nulo.

[in, out] pcFound

Na entrada, indica o número de instâncias a serem pesquisadas. Por exemplo, *pcFound = 1 pode ser chamado para localizar a primeira ocorrência. A pesquisa é interrompida quando uma é encontrada.

Na saída, indica o número de instâncias que foram encontradas. Se os valores de entrada e saída de *pcFound forem idênticos, poderá haver mais descrições de tipo que contenham o nome.

Retornar valor

Esse método pode retornar um desses valores.

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

Comentários

Passar *pcFound = n indica que há espaço suficiente nas matrizes ppTInfo e rgMemId para pares n (ptinfo, memid). A função retornará MEMBERID_NIL em rgMemId[i], se o nome em szNameBuf for o nome das informações de tipo em ppTInfo[i].

Requisitos

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

Confira também

Itypelib