IRunnableTask 인터페이스(shobjidl_core.h)
백그라운드 스레드에서 작업을 수행할 수 있도록 개체에 의해 노출될 수 있는 자유 스레드 인터페이스입니다. 예를 들어 IExtractImage::GetLocation 메서드가 E_PENDING 반환하는 경우 호출 애플리케이션은 백그라운드 스레드에서 이미지를 추출할 수 있습니다.
상속
IRunnableTask 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IRunnableTask 에는 다음과 같은 유형의 멤버도 있습니다.
메서드
IRunnableTask 인터페이스에는 이러한 메서드가 있습니다.
| IRunnableTask::IsRunning 썸네일 추출과 같은 작업 상태에 대한 정보를 요청합니다. |
| IRunnableTask::Kill 작업을 중지할 것을 요청합니다. |
| IRunnableTask::Resume 작업이 다시 시작되도록 요청합니다. |
| IRunnableTask::Run 작업이 시작되도록 요청합니다. |
| IRunnableTask::Suspend 작업을 일시 중단할 것을 요청합니다. |
설명
네임스페이스 확장이 자유 스레드이고 아이콘 추출과 같은 작업을 스케줄러에서 관리하도록 허용하려는 경우 IRunnableTask 를 구현합니다. 실행 및 IsRunning 메서드만 구현해야 합니다. Kill, Resume 및 Suspend를 구현하지 않으려면 단순히 E_NOTIMPL 반환하도록 합니다.
IRunnableTask를 사용하여 백그라운드 스레드에서 이미지를 추출하는 경우, 즉 개체가 IExtractImage를 노출하는 경우 시스템에서 IExtractImage::Extract를 사용하여 작업을 관리하므로 실행이 필요하지 않습니다. 다른 메서드(Kill, Resume 및 Suspend)는 이 경우 선택 사항이지만 구현되는 경우 시스템에서 사용됩니다.
이 인터페이스를 직접 호출하지 않습니다. IRunnableTask 는 애플리케이션이 이 인터페이스를 알고 있음을 확인한 경우에만 운영 체제에서 사용됩니다.
IRunnableTask 는 5개의 나열된 메서드뿐만 아니라 IUnknown 을 구현합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional, Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | shobjidl_core.h(Shobjidl.h 포함) |