ICCMTargetedUpdate::GetProgress Method

  • Article

Applies To: System Center Configuration Manager 2007, System Center Configuration Manager 2007 R2, System Center Configuration Manager 2007 R3, System Center Configuration Manager 2007 SP1, System Center Configuration Manager 2007 SP2

The GetProgress method, in Configuration Manager, gets the software update installation progress.

[IDL]
HRESULT GetProgress(
     VARIANT*  pvarUpdateStatus,
     VARIANT*  pvarPercentComplete,
     VARIANT*  pvarError
);

Parameters

  • pvarUpdateStatus
    Data type: VARIANT

    Qualifiers: [in, out]

    Pointer to an unsigned long value in a variant giving the current progress status of the update. Possible values are shown below. This parameter must not be set to a null pointer.

    • ciJobStateNone

    • ciJobStateAvailable

    • ciJobStateSubmitted

    • ciJobStateDetecting

    • ciJobStateDownloadingCIDef

    • ciJobStateDownloadingSdmPkg

    • ciJobStatePreDownload

    • ciJobStateDownloading

    • ciJobStateWaitInstall

    • ciJobStateInstalling

    • ciJobStatePendingSoftReboot

    • ciJobStatePendingHardReboot

    • ciJobStateWaitReboot

    • ciJobStateVerifying

    • ciJobStateInstallComplete

    • ciJobStateError

    • ciJobStateWaitServiceWindow

  • pvarPercentComplete
    Data type: VARIANT

    Qualifiers: [in, out]

    Pointer to the percentage complete of the status provided in parameter pvarUpdateStatus. The pvarPercentComplete parameter must not be set to a null pointer.

  • pvarError
    Data type: VARIANT

    Qualifiers: [in, out]

    Pointer to an actual error code if pvarUpdateStatus is set to ciJobStateError. For other status values, this parameter can be ignored. It must not be set to a null pointer.

Return Values

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

  • S_OK
    The method succeeded.

Requirements

Runtime Requirements

For more information, see Configuration Manager Client Runtime Requirements.

Development Requirements

For more information, see Configuration Manager Client Development Requirements.

See Also

Concepts

ICCMTargetedUpdate Interface