Share via


EnumLocks Method

This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

The EnumLocks method returns a QueryResults object that enumerates the resource locks held by an instance of Microsoft SQL Server.

Syntax

object
.EnumLocks( [ Who ] )as QueryResults

Parts

  • object
    Expression that evaluates to an object in the Applies To list.
  • Who
    Optionally restricts output by process identifier.

Prototype (C/C++)

HRESULT EnumLocks(
LPSQLDMOQUERYRESULTS* ppResults,
long Who = -1);

Returns

A QueryResults object that contains one result set defined by these columns.

Column Data type Description

dbname

nvarchar(129)

Name of the database in which the locked resource is defined.

indexname

nvarchar(129)

If applicable, the name of the index against which the lock is applied.

locktype

nvarchar(36)

A text description of a locking mode. For more information about interpreting values, see the description of the system table syslockinfo column req_mode.

req_spid

integer

Process ID of the process requesting the lock.

status

tinyint

An integer indicating lock application status. For more information about interpreting values, see the description of the system table syslockinfo column req_status.

tablename

nvarchar(129)

If applicable, the name of the table against which the lock is applied.

Remarks

When restricting the QueryResults object content using the Who argument, use the process ID that identifies the login or other process targeted. The EnumProcesses method can help identify a target process.

Applies To:

Database Object

SQLServer Object

See Also

Reference

EnumProcesses Method

Other Resources

sys.syslockinfo (Transact-SQL)

Help and Information

Getting SQL Server 2005 Assistance