Funzione GetThreadDescription (processthreadsapi.h)
Recupera la descrizione assegnata a un thread chiamando SetThreadDescription.
Sintassi
HRESULT GetThreadDescription(
[in] HANDLE hThread,
[out] PWSTR *ppszThreadDescription
);
Parametri
[in] hThread
Handle per il thread per cui recuperare la descrizione. L'handle deve avere THREAD_QUERY_LIMITED_INFORMATION accesso.
[out] ppszThreadDescription
Stringa Unicode contenente la descrizione del thread.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è HRESULT che indica un'operazione riuscita. Se la funzione ha esito negativo, il valore restituito è un VALORE HRESULT che indica l'errore.
Commenti
Windows Server 2016, Windows 10 LTSB 2016 e Windows 10 versione 1607: GetThreadDescription è disponibile solo da Run Time Dynamic Linking in KernelBase.dll.
La descrizione di un thread può cambiare in qualsiasi momento. Ad esempio, un thread diverso può modificare la descrizione di un thread di interesse durante il tentativo di recuperare tale descrizione.
Le descrizioni dei thread non devono essere univoce.
Per liberare la memoria per la descrizione del thread, chiamare il metodo LocalFree .
Esempio
L'esempio seguente ottiene la descrizione per un thread, stampa la descrizione e quindi libera la memoria per la descrizione.
HRESULT hr = GetThreadDescription(ThreadHandle, &data);
if (SUCCEEDED(hr))
{
wprintf(“%ls\n”, data);
LocalFree(data);
}
Requisiti
| Client minimo supportato | Windows 10, versione 1607 [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2016 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | processthreadsapi.h |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |