BitsClientJob class

  • Article

The BitsClientJob class provides methods to manage Background Intelligent Transfer Service (BITS) transfer jobs.

The following syntax is simplified from Managed Object Format (MOF) code and includes all of the inherited properties. Properties are listed in alphabetical order, not MOF order.

Syntax

[Provider("BitsClientProv"), Dynamic]
class BitsClientJob
{
  string         JobId;
  string         DisplayName;
  string         Description;
  uint32         Priority;
  uint32         MinimumRetryDelay;
  uint32         NoProgressTimeout;
  BitsClientFile Files[];
  uint64         JobCreationTime;
  uint64         JobLastModificationTime;
  uint64         JobCompletionTime;
  uint64         BytesTotal;
  uint64         BytesTransferred;
  uint32         FilesTotal;
  uint32         FilesTransferred;
  uint32         TransientErrorCount;
  uint16         State;
  string         Owner;
};

Members

The BitsClientJob class has these types of members:

  • Methods
  • Properties

Methods

The BitsClientJob class has these methods.

Method Description
AddFile

Adds a file to an existing BITS transfer job.
CreateJob

Creates a BITS transfer job.
GetError

Gets the error codes and error context for a BITS transfer job error.
RemoveClientCertificate

Removes the client certificate from the job.
RemoveCredentials

Removes the credentials from the useTarget parameter.
SetClientCertificateById

Sets the client certificate to use for client authentication in an HTTPS (SSL) request.
SetClientCertificateByName

Sets the client certificate to use for client authentication in an HTTPS (SSL) request.
SetCredentials

Identifies the Target parameter, the authentication scheme, and the user credentials to use for user authentication requests.
SetJobState

Changes the state of a BITS transfer job.
SetProxySettings

Modifies the proxy settings for a BITS transfer job.

 

Properties

The BitsClientJob class has these properties.

BytesTotal

Data type: uint64

Access type: Read-only

This property specifies the total number of bytes to transfer for all the files in the BITS transfer job.

BytesTransferred

Data type: uint64

Access type: Read-only

This property specifies the number of bytes that were transferred.

Description

Data type: string

Access type: Read/write

This property specifies the description of the BITS transfer job.

DisplayName

Data type: string

Access type: Read/write

This property specifies the name of the BITS transfer job.

Files

Data type: BitsClientFile array

Access type: Read-only

This property gets the list of files that were added to the BITS transfer job.

FilesTotal

Data type: uint32

Access type: Read-only

This property specifies the total number of files to transfer for this BITS transfer job.

FilesTransferred

Data type: uint32

Access type: Read-only

This property specifies the number of files transferred.

JobCompletionTime

Data type: uint64

Access type: Read-only

This property specifies the time when the BITS transfer job entered the completed state. The HighDateTime parameter is in most significant bits (MSB), and the LowDateTime parameter is in least significant bits (LSB).

JobCreationTime

Data type: uint64

Access type: Read-only

This property specifies the creation time of the BITS transfer job. The HighDateTime parameter is in MSB, and the LowDateTime parameter is in LSB.

JobId

Data type: string

Access type: Read-only

This property specifies the GUID that is associated with the BITS transfer job.

JobLastModificationTime

Data type: uint64

Access type: Read-only

This property specifies the last modification time of the BITS transfer job. The HighDateTime parameter is in MSB, and the LowDateTime parameter is in LSB.

MinimumRetryDelay

Data type: uint32

Access type: Read/write

This property specifies the minimum time that BITS waits before it tries to transfer the file after a transient error condition occurs.

NoProgressTimeout

Data type: uint32

Access type: Read/write

This property specifies the length of time that the service tries to transfer the file after a transient error condition occurs. If there is progress, the timer is reset.

Owner

Data type: string

Access type: Read-only

This property specifies the owner of the BITS transfer job.

Priority

Data type: uint32

Access type: Read/write

This property specifies the priority of the BITS transfer job.

State

Data type: uint16

Access type: Read-only

This property specifies the state of the BITS transfer job.

TransientErrorCount

Data type: uint32

Access type: Read-only

This property specifies the number of times that a transit error occurred for the BITS transfer job.

Remarks

If a BITS transfer job exists that was created by a user who no longer exists on the computer, job enumerations fail with WBEM_E_FAILED error code.

Requirements

Minimum supported client

 None supported

Minimum supported server

 Windows Server 2008 R2

Redistributable

 Windows Management Framework on Windows Server 2008 with SP2

Namespace

Root\microsoft\bits

MOF

 BitsProvider.mof