IMetaDataAssemblyImport::FindAssembliesByName 方法

使用通用語言執行平台 (CLR) 所採用的標準規則，取得具有指定 szAssemblyName 參數的組件陣列，以便解析參考。

語法

HRESULT FindAssembliesByName (  
    [in]  LPCWSTR     szAppBase,
    [in]  LPCWSTR     szPrivateBin,
    [in]  LPCWSTR     szAssemblyName,
    [out] IUnknown    *ppIUnk[],
    [in]  ULONG       cMax,
    [out] ULONG       *pcAssemblies  
);  

參數

szAppBase
[in] 要在其中搜尋指定組件的根目錄。 如果此值設定為 null，FindAssembliesByName 只會在全域組件快取中尋找組件。

szPrivateBin
[in] 根目錄下以分號分隔的子目錄清單 (例如 "bin;bin2")，可在其中搜尋組件。 除了預設探查規則中指定的目錄之外，還會探查這些目錄。

szAssemblyName
[in] 要尋找的組件名稱。 此字串的格式定義於 AssemblyName 的類別參考頁面。

ppIUnk
[out] 保存 IMetadataAssemblyImport 介面指標的陣列。

cMax
[in] 要置於 ppIUnk 的介面指標數目上限。

pcAssemblies
[out] 傳回的介面指標數目，也就是實際置於 ppIUnk 中的介面指標數目。

傳回值

HRESULT	描述
S_OK	FindAssembliesByName 成功傳回。
S_FALSE	沒有組件。

備註

假定有組件名稱，FindAssembliesByName 方法會遵循解析組件參考的標準規則來尋找組件。 (如需詳細資訊，請參閱執行階段如何找出組件。) FindAssembliesByName 可讓呼叫端設定組件解析程式內容的各種層面，例如應用程式基底和私人搜尋路徑。

FindAssembliesByName 方法要求在處理式中初始化 CLR，才能叫用組件解析邏輯。 因此，您必須在呼叫 FindAssembliesByName 之前，呼叫 CoInitializeEE (傳遞 COINITEE_DEFAULT)，然後接著呼叫 CoUninitializeCor。

FindAssembliesByName 會傳回檔案的 IMetaDataImport 指標，該檔案包含已傳入組件名稱的組件資訊清單。 如果未完整指定給定的組件名稱 (例如，如果不包含版本)，可能會傳回多個組件。

FindAssembliesByName 通常由編譯器在編譯時用於嘗試尋找參考的組件。

規格需求

平台：請參閱系統需求。

標頭：Cor.h

程式庫：作為 MSCorEE.dll 中的資源使用

.NET Framework版本：自 1.0 起可用

另請參閱

• 執行階段如何找出組件
• IMetaDataAssemblyImport 介面