Partilhar 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.

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 szName buffer de retorno.

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

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

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

Comentários

Depois que esse método retorna, você deve verificar que o szName buffer era grande o suficiente para conter o nome completo do domínio do aplicativo. Para fazer isso, comparar o valor que pcchName aponta para com o valor das cchName parâmetro. If pcchName aponta para um valor que seja maior que cchName, alocar uma maior szName buffer, atualização cchName com a novo e maior dimensionar e telefonar GetAppDomainInfo novamente.

Como alternativa, você pode primeiro telefonar GetAppDomainInfo com um comprimento zero szName buffer para obter o dimensionar do buffer correto. Você pode então conjunto o dimensionar do buffer para o valor retornado em pcchName e chame GetAppDomainInfo novamente.

Para obter mais informações sobre essas duas abordagens, consulte Buffers alocados chamador.

Requisitos

Plataformas: See Requisitos de sistema do .NET framework.

Cabeçalho: CorProf.idl

Biblioteca: CorGuids.lib

.NET Framework Versions: 3.5 SP1, 3,5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Consulte também

Referência

Interface ICorProfilerInfo

Outros recursos

Interfaces de criação de perfil

Criação de perfil (referência de API não gerenciada)