Langage de programmation - C pour Windows - API de Windows

TlsSetValue	kernel32.dll	Fixe la valeur TLS
Windows 9X, NT 3.1+, 2000, XP, 2003

BOOL TlsSetValue(DWORD dwTlsIndex, LPVOID lpvTlsValue);

Nom	Description
dwTlsIndex	Ce paramètre permet d'indiquer un index TLS alloué par la fonction TlsAlloc.
lpTlsValue	Ce paramètre permet d'indiquer la valeur à entreposer dans l'emplacement TLS du processus léger appelant spécifié par dwTlsIndex.

Valeur	Description
0	Cette valeur permet d'indiquer que la fonction a échoué. Pour obtenir des informations d'erreur étendues, appelez la fonction GetLastError.
0 !=	Ces valeurs permettent d'indiquer que l'opération a réussi.

Cette fonction permet d'entreposer la valeur d'un appel de processus d'entreposage d'une fente locale (TLS) pour un index TLS spécifié.

Les index TLS sont généralement alloués par la fonction TlsAlloc lors de l'initialisation du processus ou de la DLL. Une fois alloué, chaque processus léger du processus peut utiliser un index TLS pour accéder à son propre emplacement d'entreposage TLS pour cet index. L'emplacement de l'entreposage pour chaque processus léger est initialisé à NULL. Un processus léger spécifie un index TLS dans un appel à TlsSetValue, pour entreposer une valeur dans son emplacement. L'unité d'exécution spécifie le même index lors d'un appel ultérieur à TlsGetValue, afin de récupérer la valeur entreposée.
Les fonctions TlsSetValue et TlsGetValue ont été mis en oeuvre avec la rapidité comme objectif principal. Ces fonctions effectuent une validation minimale des paramètres et une vérification des erreurs. En particulier, cette fonction réussit si dwTlsIndex est compris entre 0 et TLS_MINIMUM_AVAILABLE. C'est au programmeur de s'assurer que l'index est valide.

Dernière mise à jour : Dimanche, le 6 décembre 2015

Section courante