GetThreadDescription 함수(processthreadsapi.h)

SetThreadDescription을 호출하여 스레드에 할당된 설명을 검색합니다.

구문

HRESULT GetThreadDescription(
  [in]  HANDLE hThread,
  [out] PWSTR  *ppszThreadDescription
);

[in] hThread

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

[out] ppszThreadDescription

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

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

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

스레드에 대한 설명은 언제든지 변경 될 수 있습니다. 예를 들어 다른 스레드는 해당 설명을 검색하는 동안 관심 있는 스레드의 설명을 변경할 수 있습니다.

스레드 설명은 고유할 필요가 없습니다.

스레드 설명에 대한 메모리를 해제하려면 LocalFree 메서드를 호출합니다.

다음 예제에서는 스레드에 대한 설명을 가져오고 설명을 인쇄한 다음 설명에 대한 메모리를 해제합니다.

HRESULT hr = GetThreadDescription(ThreadHandle, &data);
if (SUCCEEDED(hr))
{   
    wprintf(“%ls\n”, data);
    LocalFree(data);
}