Compartir vía

IHostSecurityContext::Capture (Método)

  • Artículo

Obtiene un clon de la instancia de IHostSecurityContext que se devuelve tras llamar a HostSecurityManager::GetSecurityContext.

Sintaxis

HRESULT Capture (  
    [out] IHostSecurityContext** ppClonedContext  
);

Parámetros

ppClonedContext
[out] Puntero a la dirección de un clon del objeto IHostSecurityContext que se va a capturar.

Valor devuelto

HRESULT Descripción
S_OK Capture se devolvió correctamente.
HOST_E_CLRNOTAVAILABLE El Common Language Runtime (CLR) no se ha cargado en un proceso o se encuentra en un estado en el que no puede ejecutar código administrado o procesar la llamada correctamente.
HOST_E_TIMEOUT Se agotó el tiempo de espera de la llamada.
HOST_E_NOT_OWNER El autor de la llamada no es el propietario del bloqueo.
HOST_E_ABANDONED Se canceló un evento mientras que una fibra o subproceso que estaba bloqueado lo estaba esperando.
E_FAIL Ocurrió un error grave desconocido. Si un método devuelve el valor E_FAIL, el CLR ya no se podrá usar en el proceso. Las llamadas que se hagan a los métodos de hospedaje posteriormente devolverán el valor HOST_E_CLRNOTAVAILABLE.

Comentarios

El puntero de interfaz que se devuelve desde Capture es un clon del contexto capturado. Cuando esta información se mueve por un punto de código asincrónico, su vigencia se separa de la del puntero en el que se ha realizado la llamada. Por lo tanto, se puede liberar el puntero original.

Requisitos

Plataformas: Vea Requisitos de sistema.

Encabezado: MSCorEE.h

Biblioteca: incluida como recurso en MSCorEE.dll

Versiones de .NET Framework: disponible a partir de la versión 2.0

Consulte también