SendNotifyProgressToCTM Method

 

Updated: November 1, 2013

Applies To: System Center 2012 Configuration Manager, System Center 2012 Configuration Manager SP1, System Center 2012 R2 Configuration Manager

The SendNotifyProgressToCTM method notifies Content Transfer Manager of the progress of a job.

HRESULT stdcall SendNotifyProgressToCTM(
    LPCWSTR szProgressType, 
    LPCWSTR szEndpoint, 
    LPCWSTR szID, 
    LPCWSTR szClientData, 
    LPCWSTR szBytesTotal, 
    LPCWSTR szBytesTransferred, 
    ULONG ulFilesTotal, 
    ULONG ulFilesTransferred
); 

szProgressType

Data type: LPCWSTR

Qualifiers: [in]

Either one of the S_DTS_* constants for status changes or NULL/empty string for a bytes progress only.

szEndpoint

Data type: LPCWSTR

Qualifiers: [in]

The notification endpoint. This was passed into the call to ICcmAlternateDownloadProvider::DownloadContent (szNotifyEndpoint).

szID

Data type: UInt32

Qualifiers: [in]

The job to which the notification corresponds. This is the GUID originally returned by ICcmAlternateDownloadProvider::DownloadContent.

szClientData

Data type: LPCWSTR

Qualifiers: [in]

The client-specific data which was passed into the call to ICcmAlternateDownloadProvider::DownloadContent (szNotifyData).

szBytesTotal

Data type: LPCWSTR

Qualifiers: [in]

The total number of bytes in the job.

szBytesTransferred

Data type: LPCWSTR

Qualifiers: [in]

The number of bytes transferred so far.

ulFilesTotal

Data type: ULONG

Qualifiers: [in]

The total number of files in the job.

ulFilesTransferred

Data type: ULONG

Qualifiers: [in]

The number of files transferred so far.

If the totals are not yet known, pass 0 for the values. Once the provider has determined the total byte and file count, those values should be used.

An HRESULT code. Possible values include, but are not limited to, the following:

S_OK

Success implies that discovery was triggered successfully. All other return values indicate failure.

Show: