GetThreadDescription, fonction (processthreadsapi.h)

Récupère la description affectée à un thread en appelant SetThreadDescription.

Syntaxe

HRESULT GetThreadDescription(
  [in]  HANDLE hThread,
  [out] PWSTR  *ppszThreadDescription
);

Paramètres

[in] hThread

Handle du thread pour lequel récupérer la description. Le handle doit disposer d’un accès THREAD_QUERY_LIMITED_INFORMATION.

[out] ppszThreadDescription

Chaîne Unicode qui contient la description du thread.

Valeur retournée

Si la fonction réussit, la valeur de retour est le HRESULT qui désigne une opération réussie. Si la fonction échoue, la valeur de retour est un HRESULT qui désigne l’erreur.

Notes

Windows Server 2016, Windows 10 LTSB 2016 et Windows 10 version 1607 : GetThreadDescription n’est disponible que par la liaison dynamique au moment de l’exécution dans KernelBase.dll.

La description d’un thread peut changer à tout moment. Par exemple, un autre thread peut modifier la description d’un thread d’intérêt pendant que vous essayez de récupérer cette description.

Les descriptions des threads n’ont pas besoin d’être uniques.

Pour libérer la mémoire pour la description du thread, appelez la méthode LocalFree .

Exemples

L’exemple suivant obtient la description d’un thread, imprime la description, puis libère la mémoire pour la description.

HRESULT hr = GetThreadDescription(ThreadHandle, &data);
if (SUCCEEDED(hr))
{   
    wprintf(“%ls\n”, data);
    LocalFree(data);
}

Spécifications

Voir aussi

LocalFree, SetThreadDescription