Método de IHostSecurityContext::Capture
Obtém um clone da IHostSecurityContext instância retornado de uma chamada para IHostSecurityManager::GetSecurityContext.
HRESULT Capture (
[out] IHostSecurityContext** ppClonedContext
);
Parâmetros
- ppClonedContext
[out] Um ponteiro para o endereço de um clone da IHostSecurityContext o objeto para ser capturada.
Valor de retorno
HRESULT |
Descrição |
|---|---|
S_OK |
Captureretornado com êxito. |
HOST_E_CLRNOTAVAILABLE |
O common language runtime (CLR) não foi carregado em um processo ou o CLR é em um estado em que ele não é possível executar código gerenciado ou processar a chamada com êxito. |
HOST_E_TIMEOUT |
A chamada foi esgotado. |
HOST_E_NOT_OWNER |
O chamador não possui o bloqueio. |
HOST_E_ABANDONED |
Um evento foi cancelado, enquanto um segmento bloqueado ou fibra estava esperando por ele. |
E_FAIL |
Ocorreu uma falha catastrófica desconhecida. Quando um método retorna E_FAIL, o CLR não é usável dentro do processo. As chamadas subseqüentes para hospedar os métodos retornam HOST_E_CLRNOTAVAILABLE. |
Comentários
O ponteiro de interface retornado de Capture é um clone do contexto capturado. Quando essa informação é movida em um ponto de código assíncrono, sua vida útil é separado do que o ponteiro sobre o qual a chamada foi feita. O ponteiro original, portanto, pode ser liberado.
Requisitos
Plataformas: Consulte Requisitos de sistema do .NET Framework.
Cabeçalho: MSCorEE.h
Biblioteca: Incluído como um recurso em mscoree
.NET Framework versões: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0