IHostSecurityManager::OpenThreadToken (Método)
Abre el símbolo (token) de acceso discrecional asociado al subproceso que se está ejecutando actualmente.
HRESULT OpenThreadToken (
[in] DWORD dwDesiredAccess,
[in] BOOL bOpenAsSelf,
[out] HANDLE *phThreadToken
);
Parámetros
dwDesiredAccess
[in] Máscara de valores de acceso que especifican los tipos solicitados de acceso al símbolo (token) del subproceso. Estos valores se definen en la función OpenThreadToken de Win32. Los tipos de acceso solicitados se reconcilian con la lista de control de acceso discrecional (DACL) del símbolo (token) para determinar qué tipos de acceso se deben conceder o denegar.bOpenAsSelf
[in] true para especificar que la comprobación del acceso debe realizarse utilizando el contexto de seguridad del proceso correspondiente al subproceso que realiza la llamada; false para especificar que dicha comprobación debe realizarse utilizando el contexto de seguridad del propio subproceso que realiza la llamada. Si el subproceso está suplantando a un cliente, el contexto de seguridad puede ser el de un proceso del cliente.phThreadToken
[out] Puntero al símbolo (token) del acceso que se acaba de abrir.
Valor devuelto
HRESULT |
Descripción |
---|---|
S_OK |
OpenThreadToken finalizó correctamente. |
HOST_E_CLRNOTAVAILABLE |
Common Language Runtime (CLR) no se ha cargado en un proceso o está en un estado en el que no puede ejecutar el 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 llamador no posee el bloqueo. |
HOST_E_ABANDONED |
Se canceló un evento mientras una fibra o un subproceso bloqueado estaba esperándole. |
E_FAIL |
Se ha producido un error catastrófico desconocido. Si un método devuelve E_FAIL, CLR no se puede seguir utilizando en el proceso. Las llamadas subsiguientes a métodos de hospedaje devuelven HOST_E_CLRNOTAVAILABLE. |
Comentarios
IHostSecurityManager::OpenThreadToken se comporta de forma similar a la función de Win32 correspondiente que tiene el mismo nombre, salvo que la función de Win32 permite que el llamador pase un identificador a un subproceso arbitrario, mientras que IHostSecurityManager::OpenThreadToken sólo abre el token asociado al subproceso que realiza la llamada.
El tipo HANDLE no es compatible con COM, es decir, su tamaño es específico del sistema operativo, y requiere cálculos personalizados. Por lo tanto, este token sólo puede utilizarse en el proceso, entre CLR y el host.
Requisitos
Plataformas: vea Requisitos de sistema de .NET Framework.
Encabezado: MSCorEE.h
Biblioteca: Se incluye como recurso en MsCorEE.dll
Versiones de .NET Framework: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0