Condividi tramite


Funzione SetThreadDescription (processthreadsapi.h)

Assegna una descrizione a un thread.

Sintassi

HRESULT SetThreadDescription(
  [in] HANDLE hThread,
  [in] PCWSTR lpThreadDescription
);

Parametri

[in] hThread

Handle per il thread per il quale si vuole impostare la descrizione. L'handle deve avere accesso THREAD_SET_LIMITED_INFORMATION.

[in] lpThreadDescription

Stringa Unicode che specifica 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

La descrizione di un thread può essere impostata più volte; viene usato il valore impostato più di recente. È possibile recuperare la descrizione di un thread chiamando GetThreadDescription.

Windows Server 2016, Windows 10 LTSB 2016 e Windows 10 versione 1607: SetThreadDescription è disponibile solo per Run Time Dynamic Linking in KernelBase.dll.

Esempio

Nell'esempio seguente viene impostata la descrizione del thread corrente su simulation_thread.

HRESULT hr = SetThreadDescription(GetCurrentThread(), L"simulation_thread");
if (FAILED(hr))
{
    // Call failed.
}

Requisiti

Requisito Valore
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

GetThreadDescription, Procedura: Impostare un nome di thread in Codice nativo