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

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

작업 항목 트리거를 설명하는 문자열을 검색합니다.

구문

HRESULT GetTriggerString(
  [in]  WORD   iTrigger,
  [out] LPWSTR *ppwszTrigger
);

매개 변수

[in] iTrigger

검색할 트리거의 인덱스입니다. 첫 번째 트리거는 항상 0으로 참조됩니다. 자세한 내용은 설명 부분을 참조하세요.

[out] ppwszTrigger

검색된 트리거 설명을 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 문자열이 더 이상 필요하지 않은 후에는 CoTaskMemFree 를 호출하여 이 문자열을 해제해야 합니다.

반환 값

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

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

설명

트리거 인덱스는 식별자가 아닙니다. 작업 항목과 연결된 현재 트리거를 기준으로 트리거의 위치만 나타냅니다. 예를 들어 4개의 트리거를 만드는 경우 0부터 3까지 번호가 매겨질 수 있습니다. 그러나 두 번째 트리거가 삭제되면 나머지 트리거는 0에서 2까지 번호가 매겨집니다. 첫 번째 트리거의 인덱스는 항상 0이고 마지막 트리거의 인덱스는 작업 항목의 총 트리거 수(TriggerCount -1)보다 1보다 작습니다.

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

예제

작업과 연결된 모든 트리거의 트리거 문자열을 검색하는 방법에 대한 예제는 트리거 문자열 검색 예제를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	mstask.h
라이브러리	Mstask.lib
DLL	Mstask.dll
재배포 가능 파일	Windows NT 4.0 및 Windows 95에서 인터넷 Explorer 4.0 이상

추가 정보

IScheduledWorkItem

Itask