Метод ICorProfilerInfo::GetAppDomainInfo

Принимает идентификатор домена приложения. Возвращает имя домена приложения и идентификатор процесса, который его содержит.

Синтаксис

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

Параметры

appDomainId
[in] Идентификатор домена приложения.

cchName
[in] Длина буфера возврата szName в символах.

pcchName
[out] Указатель на общую длину имени домена приложения в символах.

szName
[out] Буфер расширенных символов, предоставленный вызывающим объектом. При возврате метода параметр szName будет содержать полное или частичное имя домена приложения.

pProcessId
[out] Указатель на идентификатор процесса, который содержит этот домен приложения.

Комментарии

После возврата этого метода необходимо убедиться, что буфер szName был достаточно велик, чтобы вместить в себя полное имя домена приложения. Для этого сравните значение, на которое указывает параметр pcchName, со значением параметра cchName. Если параметр pcchName указывает на значение, превышающее значение cchName, выделите буфер szName большего размера, обновите параметр cchName, задав новый, больший размер, и вызовите метод GetAppDomainInfo снова.

Кроме того, сначала можно вызвать метод GetAppDomainInfo с буфером szName нулевой длины для получения правильного размера буфера. Затем можно задать размер буфера равным значению, возвращенному в параметре pcchName, и вызвать метод GetAppDomainInfo снова.

Требования

Платформы: см. раздел Требования к системе.

Заголовок: CorProf.idl, CorProf.h

Библиотека: CorGuids.lib

версии платформа .NET Framework: доступно с версии 2.0.

См. также раздел

• Интерфейс ICorProfilerInfo
• Профилирующие интерфейсы
• Профилирование