Método de ICorProfilerInfo::GetAssemblyInfo

Artigo
08/08/2011

Aceita uma ID de assembly e retorna o nome do assembly e a identificação do seu módulo de manifesto.

HRESULT GetAssemblyInfo(
    [in]  AssemblyID  assemblyId,
    [in]  ULONG       cchName,
    [out] ULONG       *pcchName,
    [out, size_is(cchName), length_is(*pcchName)]
          WCHAR       szName[] ,
    [out] AppDomainID *pAppDomainId,
    [out] ModuleID    *pModuleId);

Parâmetros

assemblyId
[in] O identificador do assembly.
cchName
[in] O comprimento, em caracteres, de szName.
pcchName
[out] Um ponteiro para o comprimento total de caracteres do nome do assembly.
szName
[out] Um buffer de largura de caractere fornecido pelo chamador. Quando a função retorna, ele conterá o nome do assembly.
pAppDomainId
[out] Um ponteiro para a identificação do domínio do aplicativo que contém o assembly.
pModuleId
[out] Um ponteiro para a identificação do módulo de manifesto do assembly.

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 assembly. 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 GetAssemblyInfo novamente.

Como alternativa, você pode primeiro chamar GetAssemblyInfo com um comprimento zero szName o buffer para obter o tamanho de buffer correto. É possível ajustar o tamanho do buffer baseado no valor retornado em pcchName e chame GetAssemblyInfo novamente.

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