Server.EnumProcesses Method (String)

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

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

See Also

Reference

Server Class
Server Members
Microsoft.SqlServer.Management.Smo Namespace

Other Resources

How to: Use an Enumeration Method that Returns a DataTable Object in Visual Basic .NET
Calling Methods
Managing Servers
sys.sysprocesses (Transact-SQL)

Change History

Release

History

New content:
  • Added code sample to the Example section.

  • Added to the description in the Remarks section.