IBackgroundCopyGroup::CreateJob method (qmgr.h)

[IBackgroundCopyGroup is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions. Instead, use the BITS interfaces.]

Use the CreateJob method to add a new job to the group. A group can contain only one job.

Syntax

HRESULT CreateJob(
  [in]  GUID                guidJobID,
  [out] IBackgroundCopyJob1 **ppJob
);

Parameters

[in] guidJobID

Uniquely identifies the job in the group and queue.

[out] ppJob

Pointer to an IBackgroundCopyJob1 interface pointer. Use the interface to add files and check the state of the job.

Return value

This method returns the following HRESULT values, as well as others.

Return code Description
S_OK
The job was successfully created.
QM_E_INVALID_STATE
The job is already running.
E_NOTIMPL
Only one job allowed per group.

Requirements

Requirement Value
Minimum supported client Windows XP
Minimum supported server Windows Server 2003
Target Platform Windows
Header qmgr.h
DLL QmgrPrxy.dll

See also

IBackgroundCopyGroup