IShellTaskScheduler::AddTask 메서드(shobjidl_core.h)

아티클
08/26/2023

스케줄러의 백그라운드 큐에 작업을 추가합니다.

구문

HRESULT AddTask(
  [in] IRunnableTask  *prt,
  [in] REFTASKOWNERID rtoid,
  [in] DWORD_PTR      lParam,
  [in] DWORD          dwPriority
);

매개 변수

[in] prt

형식: IRunnableTask*

큐에 추가할 작업을 나타내는 IRunnableTask 인터페이스의 instance 대한 포인터입니다.

[in] rtoid

형식: REFTASKOWNERID

작업의 소유자를 식별하는 GUID입니다. 이 정보는 나중에 소유자에 의해 계산 또는 제거 작업을 그룹화 하는 데 사용할 수 있습니다.

[in] lParam

형식: DWORD_PTR

rtoid가 소유한 작업 내에서 작업을 식별할 수 있도록 하는 사용자 정의 DWORD 값에 대한 포인터입니다. 이 작업은 작업을 ListView의 항목과 같은 특정 항목과 instance 연결하기 위해 단일 작업을 식별하거나 하위 그룹화하는 데 사용됩니다. 이 매개 변수는 0일 수 있습니다.

[in] dwPriority

형식:DWORD

작업의 우선 순위를 할당하는 다음 값 중 하나입니다. 이 우선 순위에 대한 응답은 실행 중인 다른 작업의 협력에 따라 달라집니다. 새 작업은 우선 순위 순서로 큐에 삽입됩니다. 우선 순위가 높은 작업이 추가될 때 우선 순위가 낮은 작업이 현재 실행 중인 경우 스케줄러는 실행 중인 작업을 일시 중단하려고 시도합니다. 우선 순위가 높은 작업이 완료되면 우선 순위가 낮은 작업이 다시 시작됩니다.

ITSAT_DEFAULT_PRIORITY

스케줄러가 작업에 할당한 기본 우선 순위를 적용합니다.

ITSAT_MAX_PRIORITY

높은 우선 순위.

ITSAT_MIN_PRIORITY

낮은 우선 순위.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 성공하지 않으면 HRESULT 오류 코드를 반환합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	shobjidl_core.h(Shobjidl.h 포함)
DLL	Shell32.dll(버전 5.0 이상)

다음을 통해 공유