Método IHostSecurityManager::GetSecurityContext
Obtém o IHostSecurityContext solicitado do host.
Sintaxe
HRESULT GetSecurityContext (
[in] EContextType eContextType,
[out] IHostSecurityContext** ppSecurityContext
);
Parâmetros
eContextType
[in] Um dos valores EContextType, indicando que tipo de contexto de segurança retornar.
ppSecurityContext
[out] O endereço de um ponteiro de interface para o IHostSecurityContext de eContextType.
Valor Retornado
| HRESULT | Descrição |
|---|---|
| S_OK | GetSecurityContext retornado com êxito. |
| HOST_E_CLRNOTAVAILABLE | O CLR (Common Language Runtime) não foi carregado em um processo ou está em um estado no qual não pode executar o código gerenciado ou processar a chamada com sucesso. |
| HOST_E_TIMEOUT | Uma chamada atingiu o tempo limite. |
| HOST_E_NOT_OWNER | O chamador não possui o bloqueio. |
| HOST_E_ABANDONED | Um evento foi cancelado enquanto uma fibra ou um thread bloqueado estava esperando por ele. |
| E_FAIL | Uma falha catastrófica desconhecida ocorreu. Quando um método retorna E_FAIL, o CLR não pode mais ser usado no processo. Chamadas subsequentes para métodos de hospedagem retornam HOST_E_CLRNOTAVAILABLE. |
Comentários
Um host pode controlar todo o acesso de código a tokens de thread pelo CLR e pelo código do usuário. Ele também pode garantir que as informações completas de contexto de segurança sejam passadas por operações assíncronas ou pontos de código com acesso de código restrito. IHostSecurityContext encapsula essas informações de contexto de segurança, o que é opaco para o CLR. O CLR captura essas informações e as move entre a expedição de item de trabalho do pool de threads, a execução do finalizador e a construção de módulo e classe.
Requisitos
Plataformas: confira Requisitos do sistema.
Cabeçalho: MSCorEE.h
Biblioteca: incluída como um recurso no MSCorEE.dll
Versões do .NET Framework: disponíveis desde 2.0
