NetScheduleJobGetInfo 함수(lmat.h)

아티클
08/24/2023

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

]

NetScheduleJobGetInfo 함수는 지정된 컴퓨터에서 대기 중인 특정 작업에 대한 정보를 검색합니다. 이 함수를 사용하려면 일정 서비스를 시작해야 합니다.

구문

NET_API_STATUS NET_API_FUNCTION NetScheduleJobGetInfo(
  [in, optional] LPCWSTR Servername,
  [in]           DWORD   JobId,
  [out]          LPBYTE  *PointerToBuffer
);

매개 변수

[in, optional] Servername

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

[in] JobId

정보를 검색할 작업의 식별자를 나타내는 값입니다.

[out] PointerToBuffer

지정된 작업을 설명하는 AT_INFO 구조를 수신하는 버퍼에 대한 포인터입니다. 이 버퍼는 시스템에서 할당되며 NetApiBufferFree 함수를 사용하여 해제해야 합니다. 자세한 내용은 네트워크 관리 함수 버퍼 및 네트워크 관리 함수 버퍼 길이를 참조하세요.

반환 값

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

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

설명

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

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

HKLM\System\CurrentControlSet\Control\Lsa\SubmitControl

요구 사항


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