Langage de programmation - C pour Windows - API de Windows

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

LPVOID TlsGetValue(DWORD dwTlsIndex);

Nom	Description
dwTlsIndex	Ce paramètre permet d'indiquer un index TLS alloué par la fonction TlsAlloc.

Valeur	Description
0	Cette valeur permet d'indiquer que la fonction a échoué. Pour obtenir des informations d'erreur étendues, appelez la fonction GetLastError. Notez que les données entreposées dans un emplacement TLS peuvent avoir une valeur de zéro. Dans ce cas, la valeur de retour est zéro et GetLastError renvoie NO_ERROR.
0 !=	Ces valeurs permettent d'indiquer que la valeur entreposé dans la fente TLS du processus léger appelant associé à l'index spécifié.

Cette fonction permet de demander la valeur dans 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 d'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 le paramètre dwTlsIndex est compris entre 0 et TLS_MINIMUM_AVAILABLE. C'est au programmeur de s'assurer que l'index est valide.
Les fonctions Win32 renvoyant des indications d'échec appellent SetLastError en cas d'échec. Ils n'appellent généralement pas SetLastError quand ils réussissent. La fonction TlsGetValue est une exception à cette règle générale. La fonction TlsGetValue appelle SetLastError pour effacer la dernière erreur d'un processus léger lorsqu'il réussit. Cette situation permet de vérifier la récupération sans erreur des valeurs NULL.

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

Section courante