TlsGetValue

9/8/2008

Essa função recupera o valor no local segmento do segmento de chamado armazenamento (TLS) slot para um índice TLS especificado. Cada segmento de um processo possui seu próprio slot para cada índice TLS.

Syntax

LPVOID TlsGetValue(
  DWORD dwTlsIndex
);

Parameters

• dwTlsIndex
  [no] Especifica um índice TLS que foi alocada pela função TlsAlloc.

Return Value

O valor armazenado no slot TLS do segmento de chamado associado com o índice especificado indica sucesso. Zero indica falha. Para informações de erro estendidas get, chamar GetLastError.

Os dados armazenados em um slot TLS podem ter um valor de zero. Se assim, o valor de retorno é zero, e GetLastError Retorna NO_ERROR.

Remarks

Índices TLS são geralmente alocados pelo TlsAlloc função durante o processo ou inicialização DLL. Quando alocado, cada segmento do processo pode usar um índice TLS para acessar seu próprio slot armazenamento TLS para esse índice.

Slot de armazenamento para cada segmento é inicializado para NULL.

Um segmento especifica um índice TLS em um chamar para TlsSetValue, para armazenar um valor em seu slot. O segmento especifica o mesmo índice em um chamar subseqüente para TlsGetValue, para recuperar o valor armazenado.

Windows CE 3.0 e posterior, NULL é retornado quando TlsGetValue é chamado antes TlsSetValue.

Para Windows CE 1.0 através de 2.12, o valor retornado não é garantida ser NULL.

O meta primária do TlsSetValue e TlsGetValue é a velocidade. Esses executar funções Mínimo validação de parâmetro e verificação de erro. Em particular, essa função é bem-sucedida se dwTlsIndex é o intervalo zero (0) por meio (TLS_MINIMUM_AVAILABLE – 1). Você deve garantir que o índice é válido.

Em Windows Embedded CE, quando TlsGetValue é bem-sucedida com um valor de retorno de 0, NO_ERROR é passado para a função SetLastError. Para plataformas com base em Área de trabalho Windows, TlsGetValue Define o último erro como NO_ERROR para qualquer sucesso, regardless of o valor de retorno.

Requirements

Header	winbase.h
Library	coredll.lib
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

Process and Thread Functions
SetLastError
TlsAlloc
TlsFree
TlsSetValue