ICorProfilerInfo::GetAppDomainInfo 方法

發行項
08/21/2008

更新：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。

如需有關這兩種方法的詳細資訊，請參閱由呼叫端配置的緩衝區。