ICorProfilerInfo3::GetModuleInfo2, méthode

Article
08/10/2011

Étant donné un ID de module, retourne le nom de fichier du module, l'ID de l'assembly parent du module, et un masque de bits qui décrit les propriétés du module.

HRESULT GetModuleInfo2(
    [in]  ModuleID   moduleId,
    [out] LPCBYTE    *ppBaseLoadAddress,
    [in]  ULONG      cchName,
    [out] ULONG      *pcchName,
    [out, annotation("__out_ecount_part(cchName, *pcchName)")]
          WCHAR      szName[] ,
    [out] AssemblyID *pAssemblyId);
    [out] DWORD                 *pdwModuleFlags);

Paramètres

moduleId
[in] L'ID du module pour lequel les informations seront récupérées.
ppBaseLoadAddress
[out] Adresse de base à laquelle le module est chargé.
cchName
[in] Longueur, en caractères, de la mémoire tampon de retour szName.
pcchName
[out] Pointeur vers la largeur de caractères totale du nom de fichier du module qui est retourné.
szName
[out] Mémoire tampon de caractères larges fournie par l'appelant. Lorsque cette méthode est retournée, cette mémoire tampon contient le nom de fichier du module.
pAssemblyId
[out] Pointeur vers l'ID de l'assembly parent du module.
pdwModuleFlags
[out] Un masque de bits de valeurs de l'énumération COR_PRF_MODULE_FLAGS qui spécifie les propriétés du module.

Notes

Pour les modules dynamiques, le paramètre szName est le nom de métadonnées du module, et l'adresse de base est 0 (zéro). Le nom de métadonnées est la valeur figurant dans la colonne Nom de la table Module dans les métadonnées. Cela est également exposé comme la propriété Module.ScopeName du code managé et comme le paramètre szName de la méthode IMetaDataImport::GetScopeProps du code client de métadonnées non managé.

Bien que la méthode GetModuleInfo2 puisse être appelée dès que l'ID du module existe, l'ID de l'assembly parent n'est pas disponible tant que le profileur n'a pas reçu le rappel ICorProfilerCallback::ModuleAttachedToAssembly.

Lorsque GetModuleInfo2 est retourné, vous devez vérifier que la mémoire tampon szName était assez grande pour contenir le nom de fichier complet du module. 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 GetModuleInfo2.

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

Pour plus d'informations sur ces deux approches, consultez la section « Mémoires tampon allouées par l'appelant » dans Conventions de méthode de l'API de profilage.