CurrentRunStep Property (SQL-DMO)

The CurrentRunStep property reports the currently executing step of a SQL Server Agent job.

Applies To

Syntax

object.CurrentRunStep

Part	Description
object	Expression that evaluates to an object in the Applies To list

Remarks

For executing jobs, the property reports the job step by number, and the name of the job step as a string, for example: 2 (Run Replication Agent.).

CurrentRunStep is 0 (Unknown) for jobs that are idle or whose execution status cannot be determined (CurrentRunStatus can be SQLDMOJobExecution_Idle, SQLDMOJobExecution_Suspended, or SQLDMOJobExecution_Unknown).

Data Type

String

Modifiable

Read-only

Prototype (C/C++)

HRESULT GetCurrentRunStep(SQLDMO_LPBSTR pRetVal);

Note SQL-DMO strings are always returned as OLE BSTR objects. A C/C++ application obtains a reference to the string. The application must release the reference by using SysFreeString.