IMetaDataAssemblyImport：：FindAssembliesByName 方法 (rometadataapi.h)
使用 Common Language Runtime 所採用的標準規則，取得具有指定名稱的元件數位， (CLR) 來解析參考。
語法
HRESULT FindAssembliesByName(
[in] LPCWSTR szAppBase,
[in] LPCWSTR szPrivateBin,
[in] LPCWSTR szAssemblyName,
[out] IUnknown * [] ppIUnk,
[in] ULONG cMax,
[out] ULONG *pcAssemblies
);
參數
[in] szAppBase
要在其中搜尋指定元件的根目錄。 如果此值設定為 null，FindAssembliesByName 只會在元件的全域程式集緩存中尋找。
[in] szPrivateBin
以分號分隔的子目錄清單 (，例如「bin;bin2“) 要在其中搜尋元件的根目錄下。 除了預設探查規則中指定的目錄之外，還會探查這些目錄。
[in] szAssemblyName
要尋找的元件名稱。 這個字串的格式定義於 AssemblyName 的類別參考頁面中。
[out] ppIUnk
IUnknown 類型的數位，用來放置 IMetadataAssemblyImport 介面指標。
[in] cMax
可以放在 ppIUnk中的介面指標數目上限。
[out] pcAssemblies
傳回的介面指標數目。 也就是說，實際放置於 ppIUnk中的介面指標數目。
傳回值
| HRESULT | 描述 |
|---|---|
| S_OK | FindAssembliesByName 已成功傳回。 |
| S_FALSE | 沒有組件。 |
備註
指定元件名稱時， FindAssembliesByName 方法會遵循解析元件參考的標準規則來尋找元件。 FindAssembliesByName 可讓呼叫端設定元件解析程式內容的各種層面，例如應用程式基底和私人搜尋路徑。
FindAssembliesByName 會傳回包含傳入之元件名稱之元件指令清單之檔案的 IMetaDataImport 指標。 如果未完整指定給定的組件名稱 (例如，如果不包含版本)，可能會傳回多個組件。
FindAssembliesByName 通常由編譯程式在編譯時期嘗試尋找參考的元件使用。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | rometadataapi.h |