다음을 통해 공유


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 2016Windows 10 버전 1607: GetThreadDescription은 KernelBase.dll 런타임 동적 연결에서만 사용할 수 있습니다.

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

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

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

예제

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

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

요구 사항

   
지원되는 최소 클라이언트 Windows 10 버전 1607 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2016 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 processthreadsapi.h
라이브러리 Kernel32.lib
DLL Kernel32.dll

참고 항목

LocalFree, SetThreadDescription