Funzione SetThreadDescription (processthreadsapi.h)

Articolo
03/01/2024

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

Condividi tramite