IHostSecurityContext::Capture 方法
取得從 IHostSecurityManager::GetSecurityContext呼叫傳回的 IHostSecurityContext 執行個體複製品。
語法
HRESULT Capture (
[out] IHostSecurityContext** ppClonedContext
);
參數
ppClonedContext
[out] 要擷取之 IHostSecurityContext 物件的複製品位址指標。
傳回值
| HRESULT | 描述 |
|---|---|
| S_OK | Capture 已成功傳回。 |
| HOST_E_CLRNOTAVAILABLE | 通用語言執行平台 (CLR) 尚未載入處理序，或 CLR 處於無法成功執行受控程式碼或處理呼叫的狀態。 |
| HOST_E_TIMEOUT | 呼叫逾時。 |
| HOST_E_NOT_OWNER | 呼叫端未擁有鎖定。 |
| HOST_E_ABANDONED | 封鎖的執行緒或 Fiber 在其上等候時，事件遭到取消。 |
| E_FAIL | 發生未知的重大失敗。 如果方法傳回 E_FAIL，則 CLR 就無法再用於處理序。 後續對裝載方法發出的呼叫會傳回 HOST_E_CLRNOTAVAILABLE。 |
備註
從 Capture 傳回的介面指標是所擷取內容的複製品。 當這項資訊跨非同步程式碼點移動時，其存留期會與進行呼叫的指標分開。 因此，可以釋放原始指標。
規格需求
平台：請參閱系統需求。
標題： MSCorEE.h
程式庫：包含作為 MSCorEE.dll 中的資源
.NET Framework版本：自 2.0 起提供
