ICLRAssemblyIdentityManager::GetBindingIdentityFromFile (Método)

Artículo
10/07/2008

Actualización: noviembre 2007

Obtiene los datos de enlace de identidad de ensamblado para el ensamblado en la ruta de acceso especificada.

HRESULT GetBindingIdentityFromFile(
    [in] LPCWSTR     pwzFilePath,
    [in] DWORD       dwFlags,
    [out, size_is(*pcchBufferSize)] LPWSTR pwzBuffer,
    [in, out] DWORD *pcchBufferSize
);

Parámetros

pwzFilePath
[in] Ruta de acceso al archivo que se va a evaluar.
dwFlags
[in] Valor de la enumeración ECLRAssemblyIdentityFlags que indica el tipo de identidad de un ensamblado. Se proporciona para extensibilidad futura. CLR_ASSEMBLY_IDENTITY_FLAGS_DEFAULT es el único valor admitido por la versión 2.0 de Common Language Runtime (CLR).
pwzBuffer
[out] Búfer que contiene los datos de identidad de ensamblado opaco.
pcchBufferSize
[in, out] Puntero al tamaño de pwzBuffer.

Valor devuelto

HRESULT	Descripción
S_OK	El método se devolvió correctamente.
E_INVALIDARG	El valor del parámetro pwzFilePath proporcionado es null.
ERROR_INSUFFICIENT_BUFFER	El tamaño de pwzBuffer es demasiado pequeño.
HOST_E_CLRNOTAVAILABLE	CLR no se ha cargado en un proceso o está en un estado en el que no puede ejecutar el código administrado o procesar la llamada correctamente.
HOST_E_TIMEOUT	Se agotó el tiempo de espera de la llamada.
HOST_E_NOT_OWNER	El llamador no posee el bloqueo.
HOST_E_ABANDONED	Se canceló un evento mientras una fibra o un subproceso bloqueado estaba esperándole.
E_FAIL	Se ha producido un error catastrófico desconocido. Si un método devuelve E_FAIL, CLR no se puede seguir utilizando en el proceso. Las llamadas subsiguientes a métodos de hospedaje devuelven HOST_E_CLRNOTAVAILABLE.

Comentarios

GetBindingIdentityFromFile generalmente se invoca dos veces. La primera llamada proporciona un valor null para pwzBuffer y el método devuelve el tamaño adecuado en pcchBufferSize. La segunda llamada proporciona un búfer correctamente asignado y el método proporciona los datos del búfer reales cuando finaliza.