Compartilhar via


Método ICorProfilerInfo::GetAppDomainInfo

Aceita uma ID de domínio do aplicativo. Retorna um nome de domínio do aplicativo e a ID do processo que o contém.

Sintaxe

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

Parâmetros

appDomainId
[in] A ID do domínio do aplicativo.

cchName
[in] O comprimento, em caracteres, do buffer de retorno szName.

pcchName
[out] Um ponteiro para o tamanho total do caractere do nome de domínio do aplicativo.

szName
[out] Um buffer de caractere largo fornecido pelo chamador. Quando o método for retornado, szName conterá o nome de domínio completo ou parcial do aplicativo.

pProcessId
[out] Um ponteiro para a ID do processo que contém o domínio do aplicativo.

Comentários

Depois que esse método for retornado, verifique se o buffer szName era grande o suficiente para conter o nome completo do domínio do aplicativo. Para fazer isso, compare o valor para o qual pcchName aponta com o valor do parâmetro cchName. Se pcchName apontar para um valor maior que cchName, aloque um buffer szName maior, atualize cchName com o novo tamanho maior e chame GetAppDomainInfo novamente.

Como alternativa, primeiro você pode chamar GetAppDomainInfo com um buffer szName de comprimento zero para obter o tamanho correto do buffer. Em seguida, você pode definir o tamanho do buffer como o valor retornado em pcchName e chamar GetAppDomainInfo novamente.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: CorProf.idl, CorProf.h

Biblioteca: CorGuids.lib

Versões do .NET Framework: disponíveis desde 2.0

Confira também