IBackgroundCopyManager::CreateJob 메서드(bits.h)

작업을 만듭니다.

구문

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

매개 변수

[in] DisplayName

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

[in] Type

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

[out] pJobId

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

[out] ppJob

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

반환 값

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

반환 코드	설명
S_OK	새 작업을 성공적으로 생성했습니다.
E_INVALIDARG	표시 이름이 너무 깁니다.
BG_E_TOO_MANY_JOBS_PER_MACHINE	MaxJobsPerMachine 그룹 정책 설정은 컴퓨터에서 만들 수 있는 작업 수를 결정합니다. 이 작업을 추가하면 MaxJobsPerMachine 제한이 초과됩니다.
BG_E_TOO_MANY_JOBS_PER_USER	MaxJobsPerUser 그룹 정책 설정은 사용자가 만들 수 있는 작업 수를 결정합니다. 이 작업을 추가하면 MaxJobsPerUser 제한이 초과됩니다.

설명

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

기본적으로 BITS는 한 번에 최대 300개의 작업을 지원합니다. 단일 사용자는 한 번에 최대 60개의 작업을 만들 수 있습니다. 사용자 제한은 관리자 또는 서비스 계정에 적용되지 않습니다. 이러한 기본값을 변경하려면 MaxJobsPerMachine 및 MaxJobsPerUser 그룹 정책을 각각 설정합니다.

Windows Vista 이전: BITS가 지원하거나 사용자가 만들 수 있는 작업 수에는 제한이 없습니다.

확장성 문제는 BITS 사용 시 모범 사례를 참조하세요.

예제

새 작업을 만드는 예제는 작업 만들기를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP
지원되는 최소 서버	Windows Server 2003
대상 플랫폼	Windows
헤더	bits.h
라이브러리	Bits.lib
DLL	QmgrPrxy.dll

추가 정보

작업 만들기

IBackgroundCopyJob

IBackgroundCopyJob::Resume