Funzione GetThreadDescription (processthreadsapi.h)

Articolo
08/25/2023

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

Vedere anche

LocalFree, SetThreadDescription

Share via