IBackgroundCopyQMgr::CreateGroup 메서드(qmgr.h)

[IBackgroundCopyQMgr 은 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다. 대신 BITS 인터페이스를 사용합니다.]

CreateGroup 메서드를 사용하여 새 그룹을 만들고 다운로드 큐에 추가합니다.

구문

HRESULT CreateGroup(
  [in]  GUID                 guidGroupID,
  [out] IBackgroundCopyGroup **ppGroup
);

[in] guidGroupID

다운로드 큐에서 그룹을 고유하게 식별하는 GUID입니다.

[out] ppGroup

IBackgroundCopyGroup 인터페이스 포인터에 대한 포인터입니다. 이 인터페이스를 사용하여 그룹을 관리합니다. 예를 들어 그룹에 작업을 추가하고 그룹의 속성을 설정합니다.

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

반환 코드	설명
S_OK	그룹을 만들었습니다.
E_INVALIDARG	해당 GUID를 사용하는 그룹이 이미 있습니다.