ICorProfilerInfo::GetAppDomainInfo 方法

2008-08-18

更新：2007 年 11 月

接受应用程序域 ID。返回应用程序域名称以及包含该名称的进程的 ID。

HRESULT GetAppDomainInfo(
    [in]  AppDomainID appDomainId,
    [in]  ULONG       cchName,
    [out] ULONG       *pcchName,
    [out, size_is(cchName), length_is(*pcchName)]
          WCHAR       szName[] ,
    [out] ProcessID   *pProcessId);

参数

appDomainId
[in] 应用程序域的 ID。
cchName
[in] szName 返回缓冲区的长度（以字符为单位）。
pcchName
[out] 一个指向应用程序域名称的总字符长度的指针。
szName
[out] 调用方提供的宽字符缓冲区。当方法返回时，szName 将包含整个或部分应用程序域名称。
pProcessId
[out] 一个指针，它指向包含应用程序域的进程的 ID。

备注

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

或者，您可以首先用长度为零的 szName 缓冲区调用 GetAppDomainInfo，以获取正确的缓冲区大小。然后，您可以将缓冲区大小设置为 pcchName 中返回的值，然后再次调用 GetAppDomainInfo。

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