COR_PRF_ASSEMBLY_REFERENCE_INFO 結構COR_PRF_ASSEMBLY_REFERENCE_INFO Structure

[.NET Framework 4.5.2 與更新版本提供支援][Supported in the .NET Framework 4.5.2 and later versions]

提供執行組件參考關閉查核時應考量之組件參考的相關資訊給 Common Language Runtime。Provides the common language runtime with information about an assembly reference that it should consider when performing an assembly reference closure walk.

語法Syntax

typedef struct _COR_PRF_ASSEMBLY_REFERENCE_INFO {  
    void* pbPublicKeyOrToken;  
    ULONG cbPublicKeyOrToken;  
    LPCWSTR szName;  
    ASSEMBLYMETADATA* pMetaData;  
    void* pbHashValue;  
    ULONG cbHashValue;  
    DWORD dwAssemblyRefFlags;  
} COR_PRF_EX_CLAUSE_INFO;  

成員Members

memberMember 描述Description
pbPublicKeyOrToken 組件的公開金鑰或語彙基元的指標。A pointer to the public key or token of the assembly.
cbPublicKeyOrToken 公開金鑰或語彙基元中的位元組數。The number of bytes in the public key or token.
szName 參考之組件的名稱。The name of the assembly that is referenced.
pMetaData 組件中繼資料的指標。A pointer to the assembly's metadata.
pbHashValue 雜湊二進位大型物件 (BLOB) 的指標。A pointer to a hash binary large object (BLOB).
cbHashValue 雜湊 BLOB 中的位元組數。The number of bytes in the hash BLOB.
dwAssemblyRefFlags 組件的旗標。The assembly's flags.

備註Remarks

COR_PRF_EX_CLAUSE_INFO 結構會在其宣告 Common Language Runtime 在執行組件參考關閉查核時應考量的其他組件參考時,由分析工具填入。The COR_PRF_EX_CLAUSE_INFO structure is populated by the profiler when it declares additional assembly references that the common language runtime should consider when performing an assembly reference closure walk.

如果 profiler 登錄 ICorProfilerCallback6:: GetAssemblyReferences 回呼方法,則執行時間會傳遞要載入之元件的路徑和名稱,以及指向該方法的 ICorProfilerAssemblyReferenceProvider 介面物件的指標。If the profiler registers for the ICorProfilerCallback6::GetAssemblyReferences callback method, the runtime passes the path and name of the assembly to be loaded, along with a pointer to an ICorProfilerAssemblyReferenceProvider interface object to that method. 然後,分析工具可以ICorProfilerAssemblyReferenceProvider::AddAssemblyReference COR_PRF_ASSEMBLY_REFERENCE_INFO 針對其計畫從ICorProfilerCallback6:: GetAssemblyReferences回呼中指定的元件參考的每個目標群組件,使用物件呼叫 ICorProfilerAssemblyReferenceProvider:: AddAssemblyReference 方法。The profiler can then call the ICorProfilerAssemblyReferenceProvider::AddAssemblyReference method with a COR_PRF_ASSEMBLY_REFERENCE_INFO object for each target assembly it plans to reference from the assembly specified in the ICorProfilerCallback6::GetAssemblyReferences callback.

需求Requirements

平台: 請參閱 系統需求Platforms: See System Requirements.

標頭: CorProf.idl、CorProf.hHeader: CorProf.idl, CorProf.h

程式庫: CorGuids.libLibrary: CorGuids.lib

.NET Framework 版本:自 4.5.2 起可用Available since 4.5.2.NET Framework Versions: 自 4.5.2 起可用Available since 4.5.2

另請參閱See also