Compartir a través de


sp_releaseapplock (Transact-SQL)

Libera un bloqueo en un recurso de aplicación.

Icono de vínculo a temasConvenciones de sintaxis de Transact-SQL

Sintaxis

sp_releaseapplock [ @Resource = ] 'resource_name' 
     [ , [ @LockOwner = ] 'lock_owner' ]
     [ , [ @DbPrincipal = ] 'database_principal' ]
[ ; ]

Argumentos

  • [ @Resource = ] 'resource_name'
    Es un nombre de recurso de bloqueo especificado por la aplicación cliente. La aplicación debe garantizar que el recurso es único. Al nombre especificado se le aplica internamente un algoritmo hash para obtener un valor que se puede almacenar en el administrador de bloqueos de SQL Server. resource_name es de tipo nvarchar(255) y no tiene ningún valor predeterminado. resource_name se compara con un binario, por tanto distingue entre mayúsculas y minúsculas, independientemente de la configuración de intercalación de la base de datos actual.

  • [ @LockOwner = ] 'lock_owner'
    Es el propietario del bloqueo, que es el valor de lock_owner cuando se solicitó el bloqueo. lock_owner es de tipo nvarchar(32). El valor puede ser Transaction (predeterminado) o Session. Cuando el valor de lock_owner es Transaction de manera predeterminada o se especifica como tal explícitamente, sp_getapplock debe ejecutarse desde una transacción.

  • [ @DbPrincipal = ] 'database_principal'
    Es el usuario, la función o la función de aplicación que tiene permisos para un objeto de una base de datos. El autor de la llamada de la función debe ser miembro de database_principal, dbo o la función fija de base de datos db_owner para poder llamar a la función correctamente. El valor predeterminado es public.

Valores de código de retorno

>= 0 (correcto) o < 0 (error)

Valor

Resultado

0

El bloqueo se ha liberado correctamente.

-999

Indica un error de validación de parámetros u otro error de llamada.

Notas

Si una aplicación llama a sp_getapplock varias veces para el mismo recurso de bloqueo, es necesario llamar a sp_releaseapplock el mismo número de veces para liberar el bloqueo.

Los bloqueos se liberan si el servidor se cierra por cualquier razón.

Permisos

Debe pertenecer a la función public.

Ejemplos

En el ejemplo siguiente se libera el bloqueo asociado a la transacción actual en el recurso Form1 de la base de datos AdventureWorks.

USE AdventureWorks;
GO
EXEC sp_getapplock @DbPrincipal = 'dbo', @Resource = 'Form1', 
     @LockMode = 'Shared';
EXEC sp_releaseapplock @DbPrincipal = 'dbo', @Resource = 'Form1';
GO