SetUmsThreadInformation 함수(winbase.h)

지정된 UMS(사용자 모드 예약) 작업자 스레드에 대한 애플리케이션별 컨텍스트 정보를 설정합니다.

경고

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

구문

BOOL SetUmsThreadInformation(
  [in] PUMS_CONTEXT          UmsThread,
  [in] UMS_THREAD_INFO_CLASS UmsThreadInfoClass,
  [in] PVOID                 UmsThreadInformation,
  [in] ULONG                 UmsThreadInformationLength
);

매개 변수

[in] UmsThread

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

[in] UmsThreadInfoClass

설정할 정보의 종류를 지정하는 UMS_THREAD_INFO_CLASS 값입니다. 이 매개 변수는 UmsThreadUserContext여야 합니다.

[in] UmsThreadInformation

설정할 정보가 포함된 버퍼에 대한 포인터입니다.

[in] UmsThreadInformationLength

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

반환 값

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

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

반환 코드	설명
ERROR_INFO_LENGTH_MISMATCH	버퍼 크기가 지정된 정보 클래스에 필요한 크기와 일치하지 않습니다.
ERROR_INVALID_INFO_CLASS	UmsThreadInfoClass 매개 변수는 지원되지 않는 정보 클래스를 지정합니다.
ERROR_NOT_SUPPORTED	UMS는 지원되지 않습니다.

설명

SetUmsThreadInformation 함수를 사용하여 지정된 UMS 작업자 스레드에 대한 애플리케이션 정의 컨텍스트를 설정할 수 있습니다. 컨텍스트 정보는 스케줄러별 또는 작업자별 스레드 상태와 같이 애플리케이션이 추적하는 데 유용할 수 있는 모든 항목으로 구성될 수 있습니다. UMS 작업자 스레드의 기본 구조는 시스템에서 관리되며 직접 수정해서는 안 됩니다.

QueryUmsThreadInformation 함수를 사용하여 지정된 스레드에 대해 노출된 다른 정보(예: TEB(스레드 실행 블록) 및 스레드가 일시 중단 또는 종료되었는지 여부를 검색할 수 있습니다. 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에 도입됨)

추가 정보

QueryUmsThreadInformation