Método IMetaDataAssemblyImport::FindAssembliesByName (rometadataapi.h)

Obtiene una matriz de ensamblados con el nombre especificado, utilizando las reglas estándar empleadas por Common Language Runtime (CLR) para resolver referencias.

Sintaxis

HRESULT FindAssembliesByName(
  [in]  LPCWSTR       szAppBase,
  [in]  LPCWSTR       szPrivateBin,
  [in]  LPCWSTR       szAssemblyName,
  [out] IUnknown * [] ppIUnk,
  [in]  ULONG         cMax,
  [out] ULONG         *pcAssemblies
);

Parámetros

[in] szAppBase

Directorio raíz en el que se va a buscar el ensamblado especificado. Si este valor se establece en null, FindAssembliesByName solo buscará en la caché global de ensamblados del ensamblado.

[in] szPrivateBin

Lista de subdirectorios delimitados por punto y coma (por ejemplo, "bin; bin2"), en el directorio raíz, en el que se va a buscar el ensamblado. Se sondean estos directorios además de los especificados en las reglas predeterminadas de sondeo.

[in] szAssemblyName

Nombre del ensamblado que se va a buscar. El formato de esta cadena se define en la página de referencia de clase para AssemblyName.

[out] ppIUnk

Matriz de tipo IUnknown en la que se colocan los punteros de interfaz IMetadataAssemblyImport .

[in] cMax

Número máximo de punteros de interfaz que se pueden colocar en ppIUnk.

[out] pcAssemblies

Número de punteros de interfaz devueltos. Es decir, el número de punteros de interfaz colocados realmente en ppIUnk.

Valor devuelto

HRESULT	Descripción
S_OK	FindAssembliesByName se devolvió correctamente.
S_FALSE	No hay ensamblados.

Comentarios

Dado un nombre de ensamblado, el método FindAssembliesByName busca el ensamblado siguiendo las reglas estándar para resolver referencias de ensamblado. FindAssembliesByName permite al autor de la llamada configurar varios aspectos del contexto del solucionador de ensamblados, como la base de la aplicación y la ruta de búsqueda privada.

FindAssembliesByName devuelve un puntero IMetaDataImport al archivo que contiene el manifiesto del ensamblado para el nombre del ensamblado que se pasa. Si el nombre de ensamblado dado no está completamente especificado (por ejemplo, si no incluye una versión), es posible que se devuelvan varios ensamblados.

FindAssembliesByName lo suele usar un compilador que intenta buscar un ensamblado al que se hace referencia en tiempo de compilación.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	rometadataapi.h

Consulte también

IMetaDataAssemblyImport