다음을 통해 공유


IScheduledWorkItem::D eleteTrigger 메서드(mstask.h)

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

작업 항목에서 트리거를 삭제합니다.

구문

HRESULT DeleteTrigger(
  [in] WORD iTrigger
);

매개 변수

[in] iTrigger

삭제할 트리거를 지정하는 트리거 인덱스 값입니다. 자세한 내용은 설명 부분을 참조하세요.

반환 값

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

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

설명

트리거를 만들 때 각 트리거에 대해 트리거 인덱스가 만들어집니다. 그러나 특정 트리거에 대한 고유 식별자는 아닙니다. 예를 들어 네 개의 트리거를 만드는 경우 0부터 3까지 번호가 매겨질 수 있습니다. 그러나 두 번째 트리거가 삭제되면 나머지 트리거는 0부터 2까지 번호가 매겨집니다. 첫 번째 트리거의 인덱스는 항상 0이고 마지막 트리거의 인덱스는 작업 항목의 총 트리거 수(TriggerCount -1)보다 1보다 작습니다.

IScheduledWorkItem::GetTriggerCount를 사용하여 트리거 수를 검색할 수 있습니다.

트리거 삭제를 완료하려면 프로그램에서 DeleteTrigger를 호출한 후 IPersistFile::Save 메서드를 호출해야 합니다. 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 이상

추가 정보

CreateTrigger

IScheduledWorkItem

IScheduledWorkItem::GetTriggerCount