ICorProfilerInfo::GetAssemblyInfo (Método)

2011-08-10

Acepta un Id. de ensamblado y devuelve el nombre del ensamblado y el Id. de su módulo de manifiesto.

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] Identificador del ensamblado.
cchName
[in] Longitud, en caracteres, de szName.
pcchName
[out] Puntero a longitud total en caracteres del nombre del ensamblado.
szName
[out] Búfer de carácter ancho proporcionado por llamador. La función devuelve el nombre del ensamblado.
pAppDomainId
[out] Puntero al id. del dominio de aplicación que contiene el ensamblado.
pModuleId
[out] Puntero al Id. del módulo de manifiesto del ensamblado.

Comentarios

Una vez que vuelva este método, debe comprobar que el búfer szName fuera lo bastante grande para contener el nombre completo del ensamblado. Para ello, compare el valor al que señala pcchName con el valor del parámetro cchName. Si pcchName señala a un valor mayor que cchName, asigne un búfer de szName mayor, actualice cchName con el nuevo tamaño y llame de nuevo a GetAssemblyInfo.

Otra opción es llamar primero a GetAssemblyInfo con un búfer szName de longitud cero para obtener el tamaño de búfer correcto. A continuación, puede ajustar el tamaño de búfer en función del valor devuelto en pcchName y llamar de nuevo a GetAssemblyInfo.

Para obtener más información sobre estos dos enfoques, vea Búferes asignados por el llamador.