IScheduledWorkItem::CreateTrigger 메서드(mstask.h)
[[이 API는 운영 체제 또는 제품의 후속 버전에서 변경되거나 사용할 수 없을 수 있습니다. 대신 작업 스케줄러 2.0 인터페이스를 사용하세요.] ]
작업 항목에 대한 트리거를 만듭니다.
구문
HRESULT CreateTrigger(
[out] WORD *piNewTrigger,
[out] ITaskTrigger **ppTrigger
);
매개 변수
[out] piNewTrigger
새 트리거의 반환된 트리거 인덱스 값에 대한 포인터입니다. 작업 항목과 연결된 첫 번째 트리거의 트리거 인덱스는 "0"입니다. 트리거 인덱스의 다른 용도는 비고를 참조하세요.
[out] ppTrigger
ITaskTrigger 인터페이스에 대한 포인터에 대한 포인터입니다. 현재 지원되는 작업 항목은 작업뿐입니다.
반환 값
CreateTrigger 메서드는 다음 값 중 하나를 반환합니다.
반환 코드 | Description |
---|---|
|
작업이 완료되었습니다. |
|
인수가 잘못되었습니다. |
|
사용 가능한 메모리가 부족합니다. |
설명
트리거를 검색하거나 삭제할 때 piNewTrigger 에서 반환하는 트리거 인덱스를 사용합니다. 그러나 트리거 인덱스는 식별자가 아닙니다. 작업 항목과 연결된 다른 현재 트리거를 기준으로 새 트리거의 위치만 나타냅니다.
새 트리거에 대한 조건을 설정하려면 ITaskTrigger::SetTrigger를 호출합니다.
작업 항목에 대한 새 트리거를 만든 후 애플리케이션 은 IPersistFile::Save 메서드를 호출하여 새 트리거를 디스크에 저장해야 합니다.
예제
새 트리거를 만들 때 트리거 조건을 설정하는 방법의 예는 새 트리거 만들기를 참조하세요.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
대상 플랫폼 | Windows |
헤더 | mstask.h |
라이브러리 | Mstask.lib |
DLL | Mstask.dll |
재배포 가능 파일 | Windows NT 4.0 및 Windows 95에서 인터넷 Explorer 4.0 이상 |
추가 정보
IScheduledWorkItem::D eleteTrigger
IScheduledWorkItem::GetTrigger