QueryInformationJobObject 함수(jobapi2.h)

아티클
03/11/2023

작업 개체에서 제한 및 작업 상태 정보를 검색합니다.

구문

BOOL QueryInformationJobObject(
  [in, optional]  HANDLE             hJob,
  [in]            JOBOBJECTINFOCLASS JobObjectInformationClass,
  [out]           LPVOID             lpJobObjectInformation,
  [in]            DWORD              cbJobObjectInformationLength,
  [out, optional] LPDWORD            lpReturnLength
);

매개 변수

[in, optional] hJob

정보를 쿼리하는 작업에 대한 핸들입니다. CreateJobObject 또는 OpenJobObject 함수는 이 핸들을 반환합니다. 핸들에 JOB_OBJECT_QUERY 액세스 권한이 있어야 합니다. 자세한 내용은 작업 개체 보안 및 액세스 권한을 참조하세요.

이 값이 NULL이고 호출 프로세스가 작업과 연결된 경우 호출 프로세스와 연결된 작업이 사용됩니다. 작업이 중첩된 경우 호출 프로세스의 즉시 작업이 사용됩니다.

[in] JobObjectInformationClass

쿼리할 제한에 대한 정보 클래스입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
JobObjectBasicAccountingInformation 1	lpJobObjectInfo 매개 변수는 JOBOBJECT_BASIC_ACCOUNTING_INFORMATION 구조체에 대한 포인터입니다.
JobObjectBasicAndIoAccountingInformation 8	lpJobObjectInfo 매개 변수는 JOBOBJECT_BASIC_AND_IO_ACCOUNTING_INFORMATION 구조체에 대한 포인터입니다.
JobObjectBasicLimitInformation 2	lpJobObjectInfo 매개 변수는 JOBOBJECT_BASIC_LIMIT_INFORMATION 구조체에 대한 포인터입니다.
JobObjectBasicProcessIdList 3	lpJobObjectInfo 매개 변수는 JOBOBJECT_BASIC_PROCESS_ID_LIST 구조체에 대한 포인터입니다.
JobObjectBasicUIRestrictions 4	lpJobObjectInfo 매개 변수는 JOBOBJECT_BASIC_UI_RESTRICTIONS 구조체에 대한 포인터입니다.
JobObjectCpuRateControlInformation 15	lpJobObjectInfo 매개 변수는 JOBOBJECT_CPU_RATE_CONTROL_INFORMATION 구조체에 대한 포인터입니다. Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: 이 플래그는 지원되지 않습니다.
JobObjectEndOfJobTimeInformation 6	lpJobObjectInfo 매개 변수는 JOBOBJECT_END_OF_JOB_TIME_INFORMATION 구조체에 대한 포인터입니다.
JobObjectExtendedLimitInformation 9	lpJobObjectInfo 매개 변수는 JOBOBJECT_EXTENDED_LIMIT_INFORMATION 구조체에 대한 포인터입니다.
JobObjectGroupInformation 11	lpJobObjectInfo 매개 변수는 작업이 현재 할당된 프로세서 그룹 목록을 수신하는 버퍼에 대한 포인터입니다. lpReturnLength 매개 변수가 가리키는 변수는 그룹 데이터의 크기로 설정됩니다. 그룹 수를 확인하려면 이 값을 로 `sizeof(USHORT)` 나눕니다. Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: 이 플래그는 지원되지 않습니다.
JobObjectGroupInformationEx 14	lpJobObjectInfo 매개 변수는 작업이 현재 할당된 프로세서 그룹에서 작업의 선호도를 나타내는 GROUP_AFFINITY 구조의 배열을 수신하는 버퍼에 대한 포인터입니다. lpReturnLength 매개 변수가 가리키는 변수는 그룹 선호도 데이터의 크기로 설정됩니다. 그룹 수를 확인하려면 이 값을 로 `sizeof(GROUP_AFFINITY)` 나눕니다. Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: 이 플래그는 지원되지 않습니다.
JobObjectLimitViolationInformation 13	lpJobObjectInfo 매개 변수는 JOBOBJECT_LIMIT_VIOLATION_INFORMATION 구조체에 대한 포인터입니다. Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: 이 플래그는 지원되지 않습니다.
JobObjectLimitViolationInformation2 34	lpJobObjectInfo 매개 변수는 JOBOBJECT_LIMIT_VIOLATION_INFORMATION_2 구조체에 대한 포인터입니다. Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: 이 플래그는 지원되지 않습니다.
JobObjectNetRateControlInformation 32	lpJobObjectInfo 매개 변수는 JOBOBJECT_NET_RATE_CONTROL_INFORMATION 구조체에 대한 포인터입니다. Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: 이 플래그는 지원되지 않습니다.
JobObjectNotificationLimitInformation 12	lpJobObjectInfo 매개 변수는 JOBOBJECT_NOTIFICATION_LIMIT_INFORMATION 구조체에 대한 포인터입니다. Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: 이 플래그는 지원되지 않습니다.
JobObjectNotificationLimitInformation2 33	lpJobObjectInfo 매개 변수는 JOBOBJECT_NOTIFICATION_LIMIT_INFORMATION_2 구조체에 대한 포인터입니다. Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: 이 플래그는 지원되지 않습니다.
JobObjectSecurityLimitInformation 5	이 플래그는 지원되지 않습니다. 애플리케이션은 각 프로세스에 대해 개별적으로 보안 제한을 설정해야 합니다. Windows Server 2003 및 Windows XP: lpJobObjectInfo 매개 변수는 JOBOBJECT_SECURITY_LIMIT_INFORMATION 구조체에 대한 포인터입니다.

[out] lpJobObjectInformation

제한 또는 작업 상태 정보입니다. 이 데이터의 형식은 JobObjectInfoClass 매개 변수의 값에 따라 달라집니다.

[in] cbJobObjectInformationLength

쿼리되는 작업 정보의 수(바이트)입니다. 이 값은 JobObjectInfoClass 매개 변수의 값에 따라 달라집니다.

[out, optional] lpReturnLength

lpJobObjectInfo 매개 변수가 가리키는 구조체에 기록된 데이터의 길이를 수신하는 변수에 대한 포인터입니다. 이 정보를 받지 않려면 NULL 을 지정합니다.

반환 값

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

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

설명

QueryInformationJobObject를 사용하여 현재 제한을 가져오고 수정합니다. SetInformationJobObject 함수를 사용하여 새 제한을 설정합니다.

이 함수를 사용하는 애플리케이션을 컴파일하려면 _WIN32_WINNT 0x0500 이상으로 정의합니다. 자세한 내용은 Windows 헤더 사용을 참조하세요.

요구 사항


지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	jobapi2.h(Windows.h 포함)
라이브러리	Kernel32.lib
DLL	Kernel32.dll