NetScheduleJobEnum 함수(lmat.h)
[NetScheduleJobEnum은 Windows 8 더 이상 사용할 수 없습니다. 대신 작업 스케줄러 2.0 인터페이스를 사용합니다.
]
NetScheduleJobEnum 함수는 지정된 컴퓨터에서 대기 중인 작업을 나열합니다. 이 함수를 사용하려면 일정 서비스를 시작해야 합니다.
구문
NET_API_STATUS NET_API_FUNCTION NetScheduleJobEnum(
[in, optional] LPCWSTR Servername,
[out] LPBYTE *PointerToBuffer,
[in] DWORD PrefferedMaximumLength,
[out] LPDWORD EntriesRead,
[out] LPDWORD TotalEntries,
[in, out] LPDWORD ResumeHandle
);
매개 변수
[in, optional] Servername
함수를 실행할 원격 서버의 DNS 또는 NetBIOS 이름을 지정하는 상수 문자열에 대한 포인터입니다. 이 매개 변수가 NULL이면 로컬 컴퓨터가 사용됩니다.
[out] PointerToBuffer
데이터를 수신하는 버퍼에 대한 포인터입니다. 반환 정보는 AT_ENUM 구조체의 배열입니다. 버퍼는 시스템에서 할당되며 NetApiBufferFree 함수에 대한 단일 호출을 사용하여 해제되어야 합니다. 함수가 ERROR_MORE_DATA 실패하더라도 버퍼를 해제해야 합니다.
[in] PrefferedMaximumLength
반환된 데이터의 기본 최대 길이(바이트)를 나타내는 값입니다. MAX_PREFERRED_LENGTH 지정하는 경우 함수는 데이터에 필요한 메모리 양을 할당합니다. 이 매개 변수에 다른 값을 지정하면 함수가 반환하는 바이트 수를 제한할 수 있습니다. 버퍼 크기가 모든 항목을 보유하기에 충분하지 않은 경우 함수는 ERROR_MORE_DATA 반환합니다. 자세한 내용은 네트워크 관리 함수 버퍼 및 네트워크관리 함수 버퍼 길이를 참조하세요.
[out] EntriesRead
실제로 열거된 요소 수를 수신하는 값에 대한 포인터입니다.
[out] TotalEntries
현재 다시 시작 위치에서 열거될 수 있는 총 항목 수를 수신하는 값에 대한 포인터입니다. 애플리케이션은 이 값을 힌트로만 고려해야 합니다.
[in, out] ResumeHandle
작업 열거를 계속하는 데 사용되는 다시 시작 핸들이 포함된 값에 대한 포인터입니다. 핸들은 첫 번째 호출에서 0이어야 하며 후속 호출의 경우 변경되지 않은 상태로 유지되어야 합니다. 이 매개 변수가 NULL이면 다시 시작 핸들이 저장되지 않습니다.
반환 값
함수가 성공하면 반환 값이 NERR_Success.
함수가 실패하면 반환 값은 시스템 오류 코드입니다. 오류 코드 목록은 시스템 오류 코드를 참조하세요.
설명
일반적으로 일정 작업이 열거되는 컴퓨터의 로컬 관리자 그룹의 구성원만 이 함수를 성공적으로 실행할 수 있습니다. Servername 매개 변수가 가리키는 문자열에 전달된 서버 이름이 원격 서버인 경우 서버의 로컬 Administrators 그룹의 멤버만 이 함수를 성공적으로 실행할 수 있습니다.
다음 레지스트리 값에 가장 중요한 비트 집합(예: 0x00000001)이 있는 경우 서버 연산자 그룹에 속한 사용자도 이 함수를 성공적으로 실행할 수 있습니다.
HKLM\System\CurrentControlSet\Control\Lsa\SubmitControl
반환되는 각 항목에는 AT_ENUM 구조가 포함됩니다. JobId 멤버의 값은 NetScheduleJobDel 함수와 같이 작업 식별자 매개 변수가 필요한 함수를 호출할 때 사용할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | lmat.h(Lmat.h 포함) |
| 라이브러리 | Netapi32.lib |
| DLL | Netapi32.dll |