Server.EnumProcesses Method (String)

Enumerates a list of processes running on the instance of SQL Server that are associated with the specified login.

Namespace:  Microsoft.SqlServer.Management.Smo
Assembly:  Microsoft.SqlServer.Smo (in Microsoft.SqlServer.Smo.dll)

Syntax

'Declaration
Public Function EnumProcesses ( _
    loginName As String _
) As DataTable
'Usage
Dim instance As Server 
Dim loginName As String 
Dim returnValue As DataTable 

returnValue = instance.EnumProcesses(loginName)

public DataTable EnumProcesses(
    string loginName
)

public:
DataTable^ EnumProcesses(
    String^ loginName
)

member EnumProcesses : 
        loginName:string -> DataTable

public function EnumProcesses(
    loginName : String
) : DataTable

Parameters

• loginName
  Type: System.String
  A String value that specifies the login associated with the processes running on the instance of SQL Server.

Return Value

Type: System.Data.DataTable
A DataTable object value that contains a list of processes running on the instance of SQL Server. The table describes the different columns of the returned DataTable.

Column	Data type	Description
Urn	String	The URN string that represents the process. "Server[@Name='PCNAME']/Process[@Spid='51']", for example.
Name	String	The name of the process.
Spid	Int32	The SQL Server session ID that uniquely identifies the process, see the session_id column in sys.dm_exec_sessions (Transact-SQL).
Login	String	The login running the process.
Host	String	The name of the computer on which the process is running.
Status	String	The status of the process. Running and sleeping, for example.
Command	String	The command currently being executed.
Database	String	The database is which the process is running.
Cpu	Int32	The cumulative time taken by the process in milliseconds. See the cpu_time column in sys.dm_exec_sessions (Transact-SQL).
MemUsage	Int32	The number of pages in the procedure cache that are currently allocated to the process. A negative number indicates that the process is freeing up memory allocated by another process.
BlockingSpid	Int16	The SQL Server procedure ID of the procedure that is blocking the referenced procedure..
IsSystem	Boolean	The value that specifies whether the process is a system process or not.
Program	String	The name of the program the process
ExecutionContextID	Int16	The ID value that uniquely identifies the execution context under which the process is running.

Remarks

Use this method to enumerate the processes that are currently running on the instance of SQL Server.

Examples

C#

Server srv = new Server("(local)");

DataTable d = srv.EnumProcesses("sa");
foreach (DataRow r in d.Rows)
{
   Console.WriteLine("============================================");
   foreach(DataColumn c in d.Columns)
   {
      Console.WriteLine(c.ColumnName + " = " + r[c].ToString());
   }
}

PowerShell

$srv = new-Object Microsoft.SqlServer.Management.Smo.Server("(local)")

$d = $srv.EnumProcesses("sa")
foreach ($r in $d.Rows)
{
   Write-Host "============================================"
   Foreach ($c in $d.Columns)
   {
      Write-Host $c.ColumnName "=" $r[$c]
   }
}

See Also

Reference

Server Class

EnumProcesses Overload

Microsoft.SqlServer.Management.Smo Namespace

Other Resources

Calling Methods

Managing Servers

sys.sysprocesses (Transact-SQL)