Função TlsGetValue2 (processthreadsapi.h)

Recupera o valor no slot TLS (armazenamento local do thread de chamada) para o índice TLS especificado. Cada thread de um processo tem seu próprio slot para cada índice TLS.

Sintaxe

LPVOID TlsGetValue2(
  [in] DWORD dwTlsIndex
);

Parâmetros

[in] dwTlsIndex

O índice TLS alocado pela função TlsAlloc.

Valor de retorno

Se a função for bem-sucedida, o valor retornado será o valor armazenado no slot TLS do thread de chamada associado ao índice especificado. Se dwTlsIndex for um índice válido alocado por uma chamada bem-sucedida para TlsAlloc, essa função sempre terá êxito.

Se a função falhar, o valor retornado será zero.

Observações

Os índices TLS normalmente são alocados pela função TlsAlloc durante a inicialização do processo ou da DLL. Depois que um índice TLS é alocado, cada thread do processo pode usá-lo para acessar seu próprio slot TLS para esse índice. Um thread especifica um índice TLS em uma chamada para TlsSetValue para armazenar um valor em seu slot. O thread especifica o mesmo índice em uma chamada subsequente para TlsGetValue2 para recuperar o valor armazenado.

TlsGetValue2 foi implementado com velocidade como o objetivo principal. A função executa validação mínima de parâmetro e verificação de erros. Em particular, ele terá êxito se dwTlsIndex estiver no intervalo de 0 a (TLS_MINIMUM_AVAILABLE– 1). Cabe ao programador garantir que o índice seja válido e que o thread chame TlsSetValue antes de chamar TlsGetValue2.

Essa função é idêntica a TlsGetValue, exceto por não definir o último erro do thread. Os aplicativos que chamam essa função devem evitar o uso de 0 como um valor válido, pois GetLastError não podem ser chamados para verificar se a função falhou.

Exemplos

Consulte usando de armazenamento local de thread ou usando o armazenamento local do thread em umde biblioteca de Dynamic-Link.

Requisitos

Consulte também

Funções de processo e thread

Thread Local Storage

TlsAlloc

TlsFree

TlsSetValue

APIs Vertdll disponíveis em enclaves de VBS