Método de ICorProfilerInfo::GetAppDomainInfo

Artigo
08/08/2011

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

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 identificação do domínio do aplicativo.
cchName
[in] O comprimento, em caracteres, da szName retornar buffer.
pcchName
[out] Um ponteiro para o comprimento total de caracteres do nome de domínio do aplicativo.
szName
[out] Um buffer de largura de caractere fornecido pelo chamador. Quando o método retorna, szName conterá o nome de domínio de aplicativo completo ou parcial.
pProcessId
[out] Um ponteiro para a identificação do processo que contém o domínio de aplicativo.

Comentários

Após esse método retorna, você deve verificar se o szName buffer era grande o suficiente para conter o nome completo do domínio de aplicativo. Para fazer isso, compare o valor que pcchName aponta com o valor de cchName parâmetro. Se pcchName aponta para um valor maior que cchName, alocar uma maior szName buffer, a atualização cchName com o novo tamanho maior e a chamada GetAppDomainInfo novamente.

Como alternativa, você pode primeiro chamar GetAppDomainInfo com um comprimento zero szName o buffer para obter o tamanho de buffer correto. Além disso, você pode então definir o tamanho do buffer para o valor retornado em pcchName e chame GetAppDomainInfo novamente.

Para obter mais informações sobre essas duas abordagens, consulte Buffers de Caller-Allocated.