NetScheduleJobDel 함수(lmat.h)

아티클
03/14/2023

[NetScheduleJobDel 은 Windows 8을 기준으로 더 이상 사용할 수 없습니다. 대신 작업 스케줄러 2.0 인터페이스를 사용합니다.

]

NetScheduleJobDel 함수는 컴퓨터에서 실행하기 위해 대기하는 작업 범위를 삭제합니다. 이 함수를 사용하려면 작업 삭제 요청이 전송되는 컴퓨터에서 일정 서비스를 시작해야 합니다.

구문

NET_API_STATUS NET_API_FUNCTION NetScheduleJobDel(
  [in, optional] LPCWSTR Servername,
  [in]           DWORD   MinJobId,
  [in]           DWORD   MaxJobId
);

매개 변수

[in, optional] Servername

함수를 실행할 원격 서버의 DNS 또는 NetBIOS 이름을 지정하는 상수 문자열에 대한 포인터입니다. 이 매개 변수가 NULL이면 로컬 컴퓨터가 사용됩니다.

[in] MinJobId

최소 작업 식별자입니다. MinJobId보다 작은 작업 식별자가 있는 작업은 삭제되지 않습니다.

[in] MaxJobId

최대 작업 식별자입니다. 작업 식별자가 MaxJobId 보다 큰 작업은 삭제되지 않습니다.

반환 값

함수가 성공하면 반환 값이 NERR_Success.

함수가 실패하면 반환 값은 시스템 오류 코드입니다. 오류 코드 목록은 시스템 오류 코드를 참조하세요.

설명

일반적으로 일정 작업이 삭제되는 컴퓨터의 로컬 Administrators 그룹의 멤버만 이 함수를 성공적으로 실행할 수 있습니다. Servername 매개 변수가 가리키는 문자열에 전달된 서버 이름이 원격 서버인 경우 서버의 로컬 Administrators 그룹의 멤버만 이 함수를 성공적으로 실행할 수 있습니다.

다음 레지스트리 값에 가장 중요한 비트 집합(예: 0x00000001)이 있는 경우 서버 연산자 그룹에 속한 사용자도 이 함수를 성공적으로 실행할 수 있습니다.

HKLM\System\CurrentControlSet\Control\Lsa\SubmitControl

NetScheduleJobEnum 함수를 호출하여 하나 이상의 예약된 작업에 대한 작업 식별자를 검색합니다.

NetScheduleJobDel 함수는 작업 식별자가 MaxJobId를 통해 MinJobId 범위에 있는 모든 작업을 삭제합니다.

서버에서 예약된 모든 작업을 삭제하려면 MinJobId가 0이고 MaxJobId가 – 1과 같도록 지정하는 NetScheduleJobDel을 호출할 수 있습니다. 하나의 작업을 삭제하려면 MinJobId 매개 변수와 MaxJobId 매개 변수 모두에 대한 작업의 식별자를 지정합니다.

요구 사항


지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	lmat.h(Lmat.h 포함)
라이브러리	Netapi32.lib
DLL	Netapi32.dll