SetThreadDescription 함수(processthreadsapi.h)

스레드에 설명을 할당합니다.

구문

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

[in] hThread

설명을 설정할 스레드에 대한 핸들입니다. 핸들에는 THREAD_SET_LIMITED_INFORMATION 액세스 권한이 있어야 합니다.

[in] lpThreadDescription

스레드에 대한 설명을 지정하는 유니코드 문자열입니다.

함수가 성공하면 반환 값은 성공적인 작업을 나타내는 HRESULT 입니다. 함수가 실패하면 반환 값은 오류를 나타내는 HRESULT 입니다.

스레드에 대한 설명을 두 번 이상 설정할 수 있습니다. 가장 최근에 설정된 값이 사용됩니다. GetThreadDescription을 호출하여 스레드에 대한 설명을 검색할 수 있습니다.

Windows Server 2016, Windows 10 LTSB 2016 및 Windows 10 버전 1607: SetThreadDescription은 KernelBase.dll 런타임 동적 연결에서만 사용할 수 있습니다.

다음 예제에서는 현재 스레드 simulation_thread에 대한 설명을 로 설정합니다.

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