ICorProfilerInfo::GetAppDomainInfo, méthode

Article
08/10/2011

Accepte un ID de domaine d'application. Retourne un nom de domaine d'application et l'ID du processus qui le contient.

HRESULT GetAppDomainInfo(
    [in]  AppDomainID appDomainId,
    [in]  ULONG       cchName,
    [out] ULONG       *pcchName,
    [out, size_is(cchName), length_is(*pcchName)]
          WCHAR       szName[] ,
    [out] ProcessID   *pProcessId);

Paramètres

appDomainId
[in] ID du domaine d'application.
cchName
[in] Longueur, en caractères, de la mémoire tampon de retour szName.
pcchName
[out] Pointeur vers la longueur de caractère totale du nom du domaine d'application.
szName
[out] Mémoire tampon de caractères larges fournie par l'appelant. Une fois que la méthode a retourné une valeur, szName contient le nom du domaine d'application complet ou partiel.
pProcessId
[out] Pointeur vers l'ID du processus qui contient le domaine d'application.

Notes

Une fois que cette méthode a retourné une valeur, vous devez vérifier que la mémoire tampon szName est suffisamment grande pour contenir le nom complet du domaine d'application. 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 GetAppDomainInfo.

Vous pouvez également commencer par appeler GetAppDomainInfo 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 GetAppDomainInfo.

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