ICorProfilerInfo::GetAssemblyInfo, méthode

Article
08/10/2011

Accepte un ID d'assembly et retourne le nom de l'assembly et l'ID de son module de manifeste.

HRESULT GetAssemblyInfo(
    [in]  AssemblyID  assemblyId,
    [in]  ULONG       cchName,
    [out] ULONG       *pcchName,
    [out, size_is(cchName), length_is(*pcchName)]
          WCHAR       szName[] ,
    [out] AppDomainID *pAppDomainId,
    [out] ModuleID    *pModuleId);

Paramètres

assemblyId
[in] Identificateur de l'assembly.
cchName
[in] Longueur, en caractères, de szName.
pcchName
[out] Pointeur vers la longueur de caractère totale du nom de l'assembly.
szName
[out] Mémoire tampon de caractères larges fournie par l'appelant. À son retour, la fonction contiendra le nom de l'assembly.
pAppDomainId
[out] Pointeur vers l'ID du domaine d'application qui contient l'assembly.
pModuleId
[out] Pointeur vers l'ID du module du manifeste de l'assembly.

Notes

Une fois que cette méthode a retournée une valeur, vous devez vérifier que la mémoire tampon szName était suffisamment grand pour contenir le nom complet de l'assembly. Pour ce faire, comparez la valeur pointée par pcchName avec celle du paramètre cchName. Si pcchName pointe vers une valeur supérieure à cchName, allouez une mémoire tampon szName plus grande, mettez à jour cchName avec la nouvelle taille plus grande et appelez de nouveau GetAssemblyInfo.

Vous pouvez également commencer par appeler GetAssemblyInfo avec une mémoire tampon szName dont la taille est nulle pour obtenir la taille correcte de la mémoire tampon. Vous pouvez ajuster ensuite la taille de la mémoire tampon selon la valeur retournée dans pcchName et appeler de nouveau GetAssemblyInfo.

Pour plus d'informations sur ces deux approches, consultez la page Mémoires tampons allouées par l'appelant.