SetThreadDescription 函数 (processthreadsapi.h)

为线程分配说明。

语法

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

[in] hThread

要为其设置说明的线程的句柄。句柄必须具有THREAD_SET_LIMITED_INFORMATION访问权限。

[in] lpThreadDescription

一个 Unicode 字符串，指定线程的说明。

如果函数成功，则返回值为表示操作成功的 HRESULT 。如果函数失败，则返回值为表示错误的 HRESULT 。

可以多次设置线程的说明;使用最近设置的值。可以通过调用 GetThreadDescription 来检索线程的说明。

Windows Server 2016，Windows 10LTSB 2016 和Windows 10版本 1607：SetThreadDescription 仅在 KernelBase.dll 中的运行时动态链接可用。

以下示例将当前线程的说明设置为 simulation_thread。

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