다음을 통해 공유


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개의 작업을 만들 수 있습니다. 사용자 제한은 관리자 또는 서비스 계정에 적용되지 않습니다. 이러한 기본값을 변경하려면 MaxJobsPerMachineMaxJobsPerUser 그룹 정책을 각각 설정합니다.

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

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

예제

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

요구 사항

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

추가 정보

작업 만들기

IBackgroundCopyJob

IBackgroundCopyJob::Resume