Server.EnumProcesses Method (String)

Article
12/03/2008

Enumerates a list of processes running on the instance of Microsoft 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

public DataTable EnumProcesses (
    string loginName
)

public:
DataTable^ EnumProcesses (
    String^ loginName
)

public DataTable EnumProcesses (
    String loginName
)

public function EnumProcesses (
    loginName : String
) : DataTable

Parameters

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

Return Value

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 process ID that uniquely identifies the process. For more information, see sys.sysprocesses (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 seconds. See sys.sysprocesses (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

Updated text:

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

This namespace, class, or member is supported only in version 2.0 of the Microsoft .NET Framework.

Example

'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server
'Call the EnumCollations method and return collation information to DataTable variable.
Dim d As DataTable
'Select the returned data into an array of DataRow.
d = srv.EnumCollations
'Iterate through the rows and display collation details for the instance of SQL Server.
Dim r As DataRow
Dim c As DataColumn
For Each r In d.Rows
    Console.WriteLine("============================================")
    For Each c In r.Table.Columns
        Console.WriteLine(c.ColumnName + " = " + r(c).ToString)
    Next
Next

Thread Safety

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

Target Platforms