Share via


ICIINFO::GetJobState Method

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 ICIINFO::GetJobState method, in Configuration Manager, gets the current operational state of the configuration item that is part of a job or task.

[IDL]
HRESULT GetJobState(
    CIJobState* pCIJobState,
     Percentage* ppctComplete,
     HRESULT* phrStatus
);

Parameters

  • pCIJobState
    Data type: CIJobState

    Qualifiers: [out]

    Pointer to a CIJobState Enumeration value indicating the current operational state of the configuration item. This parameter retrieves ciStatusError if the state is not available.

  • ppctComplete
    Data type: Percentage

    Qualifiers: [out]

    Pointer to a Percentage object indicating the percentage of job completion.

  • phrStatus
    Data type: HRESULT

    Qualifiers: [out]

    Pointer to an HRESULT code representing the current status. This parameter indicates an error code if pCIJobState retrieves a value of ciStatusError.

Return Values

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

  • S_OK
    The method succeeded. 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.

See Also

Concepts

ICIINFO Interface
CIJobState Enumeration