Partilhar via


Método IHostSecurityManager::GetSecurityContext

Obtém o IHostSecurityContext pedido do anfitrião.

Sintaxe

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

Parâmetros

eContextType
[in] Um dos valores EContextType , que indica o tipo de contexto de segurança a devolver.

ppSecurityContext
[fora] O endereço de um ponteiro de interface para o IHostSecurityContext de eContextType.

Devolver Valor

HRESULT Description
S_OK GetSecurityContext devolvido com êxito.
HOST_E_CLRNOTAVAILABLE O runtime de linguagem comum (CLR) não foi carregado para um processo ou o CLR está num estado em que não pode executar código gerido ou processar a chamada com êxito.
HOST_E_TIMEOUT A chamada excedeu o limite de tempo.
HOST_E_NOT_OWNER O autor da chamada não é o proprietário do bloqueio.
HOST_E_ABANDONED Um evento foi cancelado enquanto um thread ou fibra bloqueado estava à espera.
E_FAIL Ocorreu uma falha catastrófica desconhecida. Quando um método devolve E_FAIL, o CLR já não é utilizável no processo. As chamadas subsequentes para métodos de alojamento devolvem HOST_E_CLRNOTAVAILABLE.

Observações

Um anfitrião pode controlar todo o acesso de código aos tokens de thread pelo CLR e pelo código de utilizador. Também pode garantir que as informações de contexto de segurança completas são transmitidas em operações assíncronas ou pontos de código com acesso restrito ao código. IHostSecurityContext encapsula estas informações de contexto de segurança, que são opacas para o CLR. O CLR captura estas informações e move-as através da distribuição de itens de trabalho do conjunto de threads, da execução do finalizador e do módulo e da construção de classes.

Requisitos

Plataformas: Veja Requisitos de Sistema.

Cabeçalho: MSCorEE.h

Biblioteca: Incluído como um recurso no MSCorEE.dll

.NET Framework Versões: Disponível desde 2.0

Ver também