ICLRAssemblyIdentityManager::GetBindingIdentityFromFile 方法
取得位於指定檔案路徑之組件的組件識別繫結資料。
語法
HRESULT GetBindingIdentityFromFile(
[in] LPCWSTR pwzFilePath,
[in] DWORD dwFlags,
[out, size_is(*pcchBufferSize)] LPWSTR pwzBuffer,
[in, out] DWORD *pcchBufferSize
);
參數
pwzFilePath
[in] 要評估的檔案所在路徑。
dwFlags
[in] ECLRAssemblyIdentityFlags 列舉的值,表示組件的識別類型。 [in] 為了未來的擴充性而提供。 CLR_ASSEMBLY_IDENTITY_FLAGS_DEFAULT 是通用語言執行平台 (CLR) 2.0 版支援的唯一值。
pwzBuffer
[out] 包含不透明組件識別資料的緩衝區。
pcchBufferSize
[in, out] pwzBuffer
的大小指標。
傳回值
HRESULT | 描述 |
---|---|
S_OK | 此方法已成功傳回。 |
E_INVALIDARG | 提供的 pwzFilePath 為 null。 |
ERROR_INSUFFICIENT_BUFFER | pwzBuffer 的大小太小。 |
HOST_E_CLRNOTAVAILABLE | CLR 尚未載入處理序,或 CLR 處於無法執行受控程式碼或成功處理呼叫的狀態。 |
HOST_E_TIMEOUT | 呼叫逾時。 |
HOST_E_NOT_OWNER | 呼叫端未擁有鎖定。 |
HOST_E_ABANDONED | 封鎖的執行緒或 Fiber 在其上等候時,事件遭到取消。 |
E_FAIL | 發生未知的嚴重失敗。 如果方法傳回 E_FAIL,就無法在處理序中使用 CLR。 後續對裝載方法發出的呼叫會傳回 HOST_E_CLRNOTAVAILABLE。 |
備註
GetBindingIdentityFromFile
通常會呼叫兩次。 第一次呼叫會對 pwzBuffer
提供 Null 值,而方法會在 pcchBufferSize
中傳回適當的大小。 第二次呼叫會提供適當配置的緩衝區,而方法會在完成時傳回實際緩衝區資料。
規格需求
平台:請參閱系統需求。
標題: MSCorEE.h
程式庫:包含作為 MSCorEE.dll 中的資源
.NET Framework版本:自 2.0 起提供