IScheduledWorkItem::D eleteTrigger 메서드(mstask.h)
[[이 API는 운영 체제 또는 제품의 후속 버전에서 변경되거나 사용할 수 없습니다. 대신 작업 스케줄러 2.0 인터페이스를 사용하세요.] ]
작업 항목에서 트리거를 삭제합니다.
구문
HRESULT DeleteTrigger(
[in] WORD iTrigger
);
매개 변수
[in] iTrigger
삭제할 트리거를 지정하는 트리거 인덱스 값입니다. 자세한 내용은 설명 부분을 참조하세요.
반환 값
DeleteTrigger 메서드는 다음 값 중 하나를 반환합니다.
| 반환 코드 | Description |
|---|---|
|
작업이 완료되었습니다. |
|
인수가 잘못되었습니다. |
|
사용 가능한 메모리가 부족합니다. |
설명
트리거를 만들 때 각 트리거에 대해 트리거 인덱스가 만들어집니다. 그러나 특정 트리거에 대한 고유 식별자는 아닙니다. 예를 들어 네 개의 트리거를 만드는 경우 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 이상 |