ICLRAssemblyIdentityManager::GetBindingIdentityFromFile, méthode

Article
08/22/2008

Mise à jour : novembre 2007

Obtient les données d'identité d'assembly de liaison pour l'assembly dans le chemin d'accès au fichier spécifié.

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

Paramètres

pwzFilePath
[in] Chemin d'accès au fichier à évaluer.
dwFlags
[in] Valeur de l'énumération ECLRAssemblyIdentityFlags qui indique le type de l'identité d'un assembly. Fourni pour une 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 pwzFilePath fournie 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 le CLR présente un état dans lequel il ne peut pas exécuter de code managé ou traiter l'appel avec succès.
HOST_E_TIMEOUT	L'appel a expiré.
HOST_E_NOT_OWNER	L'appelant ne possède pas le verrou.
HOST_E_ABANDONED	Un événement a été annulé alors qu'un thread bloqué ou une fibre l'attendait.
E_FAIL	Une défaillance grave et inconnue s'est produite. Si une méthode retourne E_FAIL, le CLR n'est plus utilisable au sein du processus. Les appels suivants aux méthodes d'hébergement retournent HOST_E_CLRNOTAVAILABLE.

Notes

GetBindingIdentityFromFile est appelé en général 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 convenablement, et la méthode retourne les données de mémoire tampon au moment de la fermeture.