IHostSecurityManager::GetSecurityContext 方法

發行項
08/12/2011

從主應用程式取得要求的 IHostSecurityContext。

HRESULT GetSecurityContext (
    [in]  EContextType eContextType, 
    [out] IHostSecurityContext** ppSecurityContext
);

參數

eContextType
[in] 其中一個 EContextType 值，表示要傳回的安全性內容型別為何。
ppSecurityContext
[out] eContextType 的 IHostSecurityContext 之介面指標位址。

傳回值

HRESULT	描述
S_OK	GetSecurityContext 已成功傳回。
HOST_E_CLRNOTAVAILABLE	Common Language Runtime (CLR) 尚未載入至處理序中，或者此 CLR 目前的狀態無法執行 Managed 程式碼或成功處理呼叫。
HOST_E_TIMEOUT	呼叫已逾時。
HOST_E_NOT_OWNER	呼叫端不具備鎖定功能。
HOST_E_ABANDONED	已封鎖執行緒或 Fiber 在等候事件時，該事件已遭取消。
E_FAIL	發生未知的重大錯誤。當方法傳回 E_FAIL 時，便無法在處理序內使用 CLR。對裝載方法的後續呼叫會傳回 HOST_E_CLRNOTAVAILABLE。

備註

主應用程式可以控制 CLR 和使用者程式碼對執行緒語彙基元的所有程式碼存取。它也可以確保完整的安全性內容資訊是利用受限程式碼存取權，傳遞到非同步作業或字碼指標。 IHostSecurityContext 會封裝此安全性內容資訊，這對於 CLR 而言是不透明的。 CLR 會擷取這項資訊，並將它在執行緒集區背景工作項目分派、完成項執行以及模組和類別建構之間移動。