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

Busca apariciones de una descripción de tipo en una biblioteca de tipos. Esto puede usarse para comprobar rápidamente que existe un nombre en una biblioteca de tipos.

Sintaxis

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

Parámetros

[in, out] szNameBuf

Nombre que se va a buscar.

[in] lHashVal

Valor hash para acelerar la búsqueda, calculada por la función LHashValOfNameSys . Si lHashVal = 0, se calcula un valor.

[out] ppTInfo

Matriz de punteros a las descripciones de tipo que contienen el nombre especificado en szNameBuf. Este parámetro no puede ser null.

[out] rgMemId

Matriz de los elementos encontrados; rgMemId[i] es el MEMBERID que indexa en la descripción del tipo especificada por ppTInfo[i]. Este parámetro no puede ser null.

[in, out] pcFound

En la entrada, indica el número de instancias que se van a buscar. Por ejemplo, se puede llamar a *pcFound = 1 para encontrar la primera aparición. La búsqueda se detiene cuando se encuentra una.

En la salida, indica el número de instancias encontradas. Si los valores de in y out de *pcFound son idénticos, puede haber más descripciones de tipos que contengan el nombre.

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

Pasar *pcFound = n indica que hay suficiente espacio en las matrices ppTInfo y rgMemId para los pares n (ptinfo, memid). La función devuelve MEMBERID_NIL en rgMemId[i], si el nombre de szNameBuf es el nombre de la información de tipo en ppTInfo[i].

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	oaidl.h

Consulte también

ITypeLib