IBackgroundCopyJob::SetPriority method

Specifies the priority level of your job. The priority level determines when your job is processed relative to other jobs in the transfer queue.

Syntax

HRESULT SetPriority(
  BG_JOB_PRIORITY Val
);

Parameters

Val

Specifies the priority level of your job relative to other jobs in the transfer queue. The default is BG_JOB_PRIORITY_NORMAL. For a list of priority levels, see the BG_JOB_PRIORITY enumeration.

Return Value

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

Return code Description
S_OK
Job priority was successfully set.
E_NOTIMPL
The value for Priority is not defined in the BG_JOB_PRIORITY enumeration.
BG_E_INVALID_STATE
The state of the job cannot be BG_JOB_STATE_CANCELLED or BG_JOB_STATE_ACKNOWLEDGED.

Requirements

   
Minimum supported client Windows XP
Minimum supported server Windows Server 2003
Target Platform Windows
Header bits.h
Library Bits.lib
DLL QmgrPrxy.dll

See Also

BG_JOB_PRIORITY

IBackgroundCopyJob::GetPriority