IMetaDataAssemblyEmit::DefineAssemblyRef 方法

針對這個組件參考的組件，建立包含中繼資料的 AssemblyRef 結構，並且傳回關聯的中繼資料語彙基元。

HRESULT DefineAssemblyRef (
    [in]  void                *pbPublicKeyOrToken,
    [in]  ULONG               cbPublicKeyOrToken,
    [in]  LPCWSTR             szName,
    [in]  ASSEMBLYMETADATA    pMetaData,
    [in]  void                *pbHashValue,
    [in]  ULONG               cbHashValue,
    [in]  DWORD               dwAssemblyRefFlags,
    [out] mdAssemblyRef       *pmdar
);

參數

• pbPublicKeyOrToken
  [in] 參考組件發行者的公開金鑰。 可以使用 Helper 函式 StrongNameTokenFromAssembly，來取得做為此參數傳遞的公開金鑰雜湊。

• cbPublicKeyOrToken
  [in] pbPublicKeyOrToken 的大小 (以位元組為單位)。

• szName
  [in] 組件之人們可讀取的文字名稱。 這個值不能超過 1024 個字元。

• pMetaData
  [in] ASSEMBLYMETADATA 執行個體，包含所參考組件的版本、平台和地區設定 (Locale) 資訊。

• pbHashValue
  [in] 與參考組件有關聯的雜湊資料。 選擇項。

• cbHashValue
  [in] pbHashValue 的大小 (以位元組為單位)。

• dwAssemblyRefFlags
  [in] AssemblyRefFlags 值的位元組合，這些值會影響執行引擎的行為。

• pmdar
  [out] 所傳回 AssemblyRef 中繼資料語彙基元的指標。

備註

這個組件參考的每個組件，都必須定義一個 AssemblyRef 中繼資料結構。

在執行階段，參考組件的詳細資料會傳遞至組件解析程式，並且表示其為「依建置」資訊。 組件解析程式接著會套用原則。

需求

**平台：**請參閱 .NET Framework 系統需求。

**標頭：**Cor.h

**程式庫：**當做 MsCorEE.dll 中的資源使用

**.NET Framework 版本：**4、3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0、1.1、1.0

請參閱

參考

IMetaDataAssemblyEmit 介面