QueryUmsThreadInformation 함수(winbase.h)

지정된 UMS(사용자 모드 예약) 작업자 스레드에 대한 정보를 검색합니다.

경고

Windows 11 현재 사용자 모드 일정은 지원되지 않습니다. 오류로 모든 호출이 실패합니다 ERROR_NOT_SUPPORTED.

구문

BOOL QueryUmsThreadInformation(
  [in]            PUMS_CONTEXT          UmsThread,
  [in]            UMS_THREAD_INFO_CLASS UmsThreadInfoClass,
  [out]           PVOID                 UmsThreadInformation,
  [in]            ULONG                 UmsThreadInformationLength,
  [out, optional] PULONG                ReturnLength
);

매개 변수

[in] UmsThread

UMS 스레드 컨텍스트에 대한 포인터입니다.

[in] UmsThreadInfoClass

검색할 정보의 종류를 지정하는 UMS_THREAD_INFO_CLASS 값입니다.

[out] UmsThreadInformation

지정된 정보를 받을 버퍼에 대한 포인터입니다. 이 버퍼의 필수 크기는 지정된 정보 클래스에 따라 달라집니다.

정보 클래스가 UmsThreadContext 또는 UmsThreadTeb이면 버퍼는 이어야 sizeof(PVOID)합니다.

정보 클래스가 UmsThreadIsSuspended 또는 UmsThreadIsTerminated이면 버퍼는 이어야 sizeof(BOOLEAN)합니다.

[in] UmsThreadInformationLength

UmsThreadInformation 버퍼의 크기(바이트)입니다.

[out, optional] ReturnLength

ULONG 변수에 대한 포인터입니다. 출력 시 이 매개 변수는 UmsThreadInformation 버퍼에 기록된 바이트 수를 받습니다.

반환 값

함수가 성공하면 0이 아닌 값을 반환합니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다. 가능한 오류 값은 다음과 같습니다.

반환 코드	설명
ERROR_INFO_LENGTH_MISMATCH	버퍼가 너무 작아서 요청된 정보가 없습니다.
ERROR_INVALID_INFO_CLASS	지정된 정보 클래스는 지원되지 않습니다.
ERROR_NOT_SUPPORTED	UMS는 지원되지 않습니다.

설명

QueryUmsThreadInformation 함수는 애플리케이션 정의 컨텍스트, TEB(스레드 실행 블록) 및 스레드가 일시 중단 또는 종료되는지 여부와 같은 지정된 UMS 작업자 스레드에 대한 정보를 검색합니다.

UMS 작업자 스레드의 기본 구조는 시스템에서 관리됩니다. QueryUmsThreadInformation을 통해 노출되지 않는 정보는 예약된 것으로 간주되어야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7(64비트 전용) [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	winbase.h(Windows.h 포함)
라이브러리	Kernel32.lib
DLL	Kernel32.dll
API 세트	api-ms-win-core-ums-l1-1-0(Windows 7에 도입됨)

추가 정보

SetUmsThreadInformation

UMS_THREAD_INFO_CLASS