SendNotifyProgressToCTM Method
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.
Syntax
HRESULT stdcall SendNotifyProgressToCTM(
LPCWSTR szProgressType,
LPCWSTR szEndpoint,
LPCWSTR szID,
LPCWSTR szClientData,
LPCWSTR szBytesTotal,
LPCWSTR szBytesTransferred,
ULONG ulFilesTotal,
ULONG ulFilesTransferred
);
Parameters
szProgressType
Data type: LPCWSTRQualifiers: [in]
Either one of the S_DTS_* constants for status changes or NULL/empty string for a bytes progress only.
szEndpoint
Data type: LPCWSTRQualifiers: [in]
The notification endpoint. This was passed into the call to ICcmAlternateDownloadProvider::DownloadContent (szNotifyEndpoint).
szID
Data type: UInt32Qualifiers: [in]
The job to which the notification corresponds. This is the GUID originally returned by ICcmAlternateDownloadProvider::DownloadContent.
szClientData
Data type: LPCWSTRQualifiers: [in]
The client-specific data which was passed into the call to ICcmAlternateDownloadProvider::DownloadContent (szNotifyData).
szBytesTotal
Data type: LPCWSTRQualifiers: [in]
The total number of bytes in the job.
szBytesTransferred
Data type: LPCWSTRQualifiers: [in]
The number of bytes transferred so far.
ulFilesTotal
Data type: ULONGQualifiers: [in]
The total number of files in the job.
ulFilesTransferred
Data type: ULONGQualifiers: [in]
The number of files transferred so far.
Remarks
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.
Return Values
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.
Requirements
Runtime Requirements
For more information, see Configuration Manager Client Runtime Requirements.
Development Requirements
For more information, see Configuration Manager Client Development Requirements.