IBackgroundCopyManager::CreateJob 메서드

작업을 만듭니다.

구문

HRESULT CreateJob(
  [in]  LPCWSTR            pDisplayName,
  [in]  BG_JOB_TYPE        Type,
  [out] GUID               *pJobID,
  [out] IBackgroundCopyJob **ppJob
);

매개 변수

pDisplayName [in]

작업의 표시 이름을 포함하는 Null로 끝나는 문자열입니다. 일반적으로 표시 이름은 사용자 인터페이스에서 작업을 식별하는 데 사용됩니다. 둘 이상의 작업에 동일한 표시 이름이 있을 수 있습니다. NULL이 아니어야 합니다. 이름은 null 종결자를 포함하지 않고 256자로 제한됩니다.

[ in] 입력

BG_JOB_TYPE_DOWNLOAD 같은 전송 작업의 유형입니다. 전송 형식 목록은 BG_JOB_TYPE 열거형을 참조하세요.

pJobID [out]

큐에서 작업을 고유하게 식별합니다. IBackgroundCopyManager::GetJob 메서드를 호출하여 큐에서 작업을 가져올 때 이 식별자를 사용합니다.

ppJob [out]

작업의 속성을 수정하고 전송할 파일을 지정하는 데 사용하는 IBackgroundCopyJob 인터페이스 포인터입니다. 큐에서 작업을 활성화하려면 IBackgroundCopyJob::Resume 메서드를 호출합니다. 완료되면 ppJob 을 해제합니다.

반환 값

이 메서드는 다음 HRESULT 값과 다른 값을 반환합니다.

반환 코드	설명
S_OK	새 작업을 성공적으로 생성했습니다.

설명

작업을 만드는 사용자 또는 관리자 권한이 있는 사용자만 작업에 파일을 추가하고 작업의속성을 변경할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10 버전 1709 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 버전 1709 [데스크톱 앱만 해당]
헤더	Deliveryoptimization.h
IDL	DeliveryOptimization.idl
라이브러리	Dosvc.lib
DLL	Dosvc.dll
IID	IID_IBackgroundCopyManager 5CE34C0D-0DC9-4C1F-897C-DAA1B78CEE7C로 정의됩니다.

추가 정보

IBackgroundCopyManager

IBackgroundCopyJob

IBackgroundCopyJob::Resume