ICorProfilerInfo::GetAssemblyInfo 方法

2008-08-18

更新：2007 年 11 月

接受程序集 ID 并返回程序集的名称及其清单模块的 ID。

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);

参数

assemblyId
[in] 程序集的标识符。
cchName
[in] szName 的长度（以字符为单位）。
pcchName
[out] 指向程序集名称的总字符长度的指针。
szName
[out] 调用方提供的宽字符缓冲区。当函数返回时，它将包含程序集的名称。
pAppDomainId
[out] 一个指针，它指向包含程序集的应用程序域的 ID。
pModuleId
[out] 一个指向程序集清单模块 ID 的指针。

备注

此方法返回后，您必须验证 szName 缓冲区大小是否足以包含程序集的完整名称。为此，请将 pcchName 指向的值与 cchName 参数的值进行比较。如果 pcchName 指向大于 cchName 的值，请分配更大的 szName 缓冲区，用新的、更大的大小更新 cchName，然后再次调用 GetAssemblyInfo。

或者，您可以首先用长度为零的 szName 缓冲区调用 GetAssemblyInfo，以获取正确的缓冲区大小。然后，您可以根据 pcchName 中返回的值调整缓冲区大小，并再次调用 GetAssemblyInfo。

有关这两种方法的更多信息，请参见调用方分配的缓冲区。