다음을 통해 공유


IScheduledWorkItem::CreateTrigger 메서드(mstask.h)

[[이 API는 운영 체제 또는 제품의 후속 버전에서 변경되거나 사용할 수 없을 수 있습니다. 대신 작업 스케줄러 2.0 인터페이스를 사용하세요.] ]

작업 항목에 대한 트리거를 만듭니다.

구문

HRESULT CreateTrigger(
  [out] WORD         *piNewTrigger,
  [out] ITaskTrigger **ppTrigger
);

매개 변수

[out] piNewTrigger

새 트리거의 반환된 트리거 인덱스 값에 대한 포인터입니다. 작업 항목과 연결된 첫 번째 트리거의 트리거 인덱스는 "0"입니다. 트리거 인덱스의 다른 용도는 비고를 참조하세요.

[out] ppTrigger

ITaskTrigger 인터페이스에 대한 포인터에 대한 포인터입니다. 현재 지원되는 작업 항목은 작업뿐입니다.

반환 값

CreateTrigger 메서드는 다음 값 중 하나를 반환합니다.

반환 코드 Description
S_OK
작업이 완료되었습니다.
E_INVALIDARG
인수가 잘못되었습니다.
E_OUTOFMEMORY
사용 가능한 메모리가 부족합니다.

설명

트리거를 검색하거나 삭제할 때 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 이상

추가 정보

IPersistFile::Save

IScheduledWorkItem

IScheduledWorkItem::D eleteTrigger

IScheduledWorkItem::GetTrigger

IScheduledWorkItem::GetTriggerString

ITaskTrigger

ITaskTrigger::SetTrigger