Función TlsGetValue2 (processthreadsapi.h)

Recupera el valor de la ranura de almacenamiento local (TLS) del subproceso que llama para el índice TLS especificado. Cada subproceso de un proceso tiene su propia ranura para cada índice TLS.

Sintaxis

LPVOID TlsGetValue2(
  [in] DWORD dwTlsIndex
);

Parámetros

[in] dwTlsIndex

Índice TLS asignado por la función tlsAlloc de .

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es el valor almacenado en la ranura TLS del subproceso de llamada asociada al índice especificado. Si dwTlsIndex es un índice válido asignado por una llamada correcta a TlsAlloc, esta función siempre se realiza correctamente.

Si se produce un error en la función, el valor devuelto es cero.

Observaciones

Normalmente, los índices TLS se asignan mediante la función TlsAlloc durante la inicialización del proceso o dll. Después de asignar un índice TLS, cada subproceso del proceso puede usarlo para acceder a su propia ranura TLS para ese índice. Un subproceso especifica un índice TLS en una llamada a TlsSetValue para almacenar un valor en su ranura. El subproceso especifica el mismo índice en una llamada posterior a TlsGetValue2 para recuperar el valor almacenado.

TlsGetValue2 se implementó con velocidad como objetivo principal. La función realiza la validación mínima de parámetros y la comprobación de errores. En concreto, se realiza correctamente si dwTlsIndex está en el intervalo de 0 a (TLS_MINIMUM_AVAILABLE– 1). Es necesario que el programador asegúrese de que el índice es válido y que el subproceso llama a tlsSetValue antes de llamar a TlsGetValue2.

Esta función es idéntica a TlsGetValue, salvo que no establece el último error del subproceso. Las aplicaciones que llaman a esta función deben evitar usar 0 como valor válido, ya que no se puede llamar a GetLastError para comprobar si se produjo un error en la función.

Ejemplos

Consulte Uso de de almacenamiento local de subprocesos o Uso del almacenamiento local de subprocesos en una biblioteca de Dynamic-Link.

Requisitos

Consulte también

funciones de proceso y subproceso de

de almacenamiento local de subprocesos

TlsAlloc

TlsFree

TlsSetValue

API de Vertdll disponibles en enclaves de VBS