ICorProfilerInfo::GetAssemblyInfo 方法

發行項
08/21/2008

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

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