ICLRAssemblyIdentityManager::GetBindingIdentityFromFile, méthode

Article
05/09/2023

Obtient les données de liaison d’identité d’assembly pour l’assembly au niveau du chemin de fichier spécifié.

Syntaxe

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

Paramètres

pwzFilePath
[in] Chemin du fichier à évaluer.

dwFlags
[in] Valeur de l’énumération ECLRAssemblyIdentityFlags qui indique le type d’identité d’un assembly. Fourni à des fins d’extensibilité future. CLR_ASSEMBLY_IDENTITY_FLAGS_DEFAULT est la seule valeur prise en charge par la version 2.0 du Common Language Runtime (CLR).

pwzBuffer
[out] Mémoire tampon contenant les données d’identité d’assembly opaques.

pcchBufferSize
[in, out] Pointeur vers la taille de pwzBuffer.

Valeur de retour

HRESULT	Description
S_OK	Retour réussi de la méthode.
E_INVALIDARG	La valeur fournie `pwzFilePath` est null.
ERROR_INSUFFICIENT_BUFFER	La taille de `pwzBuffer` est trop petite.
HOST_E_CLRNOTAVAILABLE	Le CLR n’a pas été chargé dans un processus ou son état ne lui permet pas d’exécuter du code managé ni de traiter l’appel correctement.
HOST_E_TIMEOUT	L’appel a expiré.
HOST_E_NOT_OWNER	L’appelant n’est pas propriétaire du verrou.
HOST_E_ABANDONED	Un événement a été annulé alors qu’un thread ou une fibre bloqué l’attendait.
E_FAIL	Une défaillance catastrophique inconnue s’est produite. Lorsqu’une méthode renvoie E_FAIL, le CLR n’est plus utilisable dans le processus. Les appels suivants aux méthodes d’hébergement renvoient HOST_E_CLRNOTAVAILABLE.

Notes

GetBindingIdentityFromFile est généralement appelé deux fois. Le premier appel fournit une valeur null pour pwzBuffer et la méthode retourne la taille appropriée dans pcchBufferSize. Le deuxième appel fournit une mémoire tampon allouée de manière appropriée, et la méthode retourne les données de mémoire tampon réelles à la fin de son exécution.

Spécifications

Plateformes : Consultez Configuration requise.

En-tête : MSCorEE.h

Bibliothèque : incluse en tant que ressource dans MsCorEE.dll

Versions de .NET Framework : Disponible depuis la version 2.0

Partager via