IScheduledWorkItem::SetFlags 메서드(mstask.h)
[[이 API는 운영 체제 또는 제품의 후속 버전에서 변경되거나 사용할 수 없습니다. 대신 작업 스케줄러 2.0 인터페이스를 사용하세요.] ]
모든 유형의 작업 항목의 동작을 수정하는 플래그를 설정합니다.
구문
HRESULT SetFlags(
DWORD dwFlags
);
매개 변수
dwFlags
다음 플래그 중 하나 이상의 조합을 지정하는 값입니다.
TASK_FLAG_INTERACTIVE
이 플래그는 Windows NT AT 서비스 작업을 작업 항목으로 변환할 때 사용됩니다. Windows NT AT 서비스 작업은 Windows NT Schedule 서비스에 대한 작업을 만드는 데 사용되는 Windows NT 명령줄 유틸리티인 At.exe 참조합니다. 작업 스케줄러 서비스는 일정 서비스를 대체하고 이전 버전과 호환됩니다. 변환은 작업 스케줄러가 Windows NT/Windows 2000에 설치될 때 발생합니다(예: 인터넷 Explorer 4.0을 설치하거나 Windows 2000으로 업그레이드하는 경우). 설치 프로세스 중에 작업 스케줄러 설치 코드는 레지스트리에서 AT 서비스에 대해 만든 작업을 검색하고 동일한 작업을 수행할 작업 항목을 만듭니다.
이러한 변환된 작업의 경우 작업 항목이 사용자에게 표시되도록 의도된 경우 대화형 플래그가 설정됩니다. 이 플래그를 설정하지 않으면 작업 항목이 작업 폴더에 표시되지 않으며 작업 항목이 실행될 때 작업 항목과 연결된 사용자 인터페이스가 사용자에게 표시되지 않습니다.
TASK_FLAG_DELETE_WHEN_DONE
예약된 실행 시간이 더 이상 없으면 작업 항목이 삭제됩니다.
TASK_FLAG_DISABLED
작업 항목을 사용할 수 없습니다. 이는 예약된 시간에 작업 항목이 실행되지 않도록 일시적으로 방지하는 데 유용합니다.
TASK_FLAG_HIDDEN
만든 작업 항목이 숨겨집니다.
TASK_FLAG_RUN_ONLY_IF_LOGGED_ON
작업 항목은 IScheduledWorkItem::SetAccountInformation 에 지정된 사용자가 대화형으로 로그온한 경우에만 실행됩니다. 이 플래그는 로컬 계정에서 실행되도록 설정된 작업 항목에 영향을 주지 않습니다.
TASK_FLAG_START_ONLY_IF_IDLE
작업 항목은 컴퓨터가 예약된 시작 시간에 사용되지 않는 경우에만 시작됩니다.
TASK_FLAG_SYSTEM_REQUIRED
시스템이 배터리 전원으로 실행되는 경우 작업 항목으로 인해 시스템이 다시 시작되거나 깨어납니다. 이 플래그는 다시 시작 타이머를 지원하는 시스템에서만 지원됩니다.
TASK_FLAG_KILL_ON_IDLE_END
작업 항목이 실행되는 동안 컴퓨터가 유휴 상태가 아닌 전환으로 유휴 상태가 되면 작업 항목이 종료됩니다. 사용자 입력 없이 IdleWait 트리거의 시간이 경과할 때까지 컴퓨터는 유휴 상태로 간주되지 않습니다. 유휴 트리거에 대한 자세한 내용은 유휴 트리거를 참조하세요.
TASK_FLAG_RESTART_ON_IDLE_RESUME
모든 작업 항목의 task_triggers 경과하기 전에 컴퓨터가 유휴 상태가 아닌 유휴 상태로 전환하면 작업 항목이 다시 시작됩니다. (이 플래그를 TASK_FLAG_KILL_ON_IDLE_END 함께 사용합니다.)
TASK_FLAG_DONT_START_IF_ON_BATTERIES
대상 컴퓨터가 배터리 전원으로 실행되는 경우 작업 항목이 시작되지 않습니다.
TASK_FLAG_KILL_IF_GOING_ON_BATTERIES
작업 항목이 종료되고 작업 항목의 대상 컴퓨터가 배터리 전원으로 전환되면 연결된 애플리케이션이 종료됩니다.
TASK_FLAG_RUN_IF_CONNECTED_TO_INTERNET
작업 항목은 현재 유효한 인터넷 연결이 있는 경우에만 실행됩니다.
반환 값
SetFlags 메서드는 다음 값 중 하나를 반환합니다.
| 반환 코드 | Description |
|---|---|
|
작업이 완료되었습니다. |
|
인수가 잘못되었습니다. |
|
사용 가능한 메모리가 부족합니다. |
설명
프로그램에서는 SetFlags를 호출하여 플래그를 업데이트한 후 IPersistFile::Save 메서드를 호출해야 합니다.
이 메서드는 예약된 작업 항목의 모든 형식에서 사용되는 플래그를 설정하는 데 사용됩니다. 반면, ITask::SetTaskFlags 는 예약된 작업에서 사용하는 플래그를 설정하는 데만 사용됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | mstask.h |
| 라이브러리 | Mstask.lib |
| DLL | Mstask.dll |
| 재배포 가능 파일 | Windows NT 4.0 및 Windows 95에서 인터넷 Explorer 4.0 이상 |