TlsSetValue
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função armazena um valor em 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
BOOL TlsSetValue(
DWORD dwTlsIndex,
LPVOID lpTlsValue
);
Parameters
- dwTlsIndex
[no] Especifica um índice TLS que foi alocada pela função TlsAlloc.
- lpTlsValue
[no] Ponteiro para o valor sejam armazenadas em slot TLS do segmento de chamado especificado por dwTlsIndex.
Return Value
Nonzero indica sucesso. Zero indica falha. Para informações de erro estendidas get, chamar GetLastError.
Remarks
Índices TLS são geralmente alocados pela função TlsAlloc 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.
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 através de (TLS_MINIMUM_AVAILABLE – 1). Você deve garantir que o índice é válido.
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 |