Share via


sp_unsetapprole (Transact-SQL)

Desactiva una función de aplicación y vuelve al contexto de seguridad anterior.

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

Sintaxis

sp_unsetapprole @cookie 

Argumentos

  • @cookie
    Especifica la cookie que se creó cuando se activó la función de aplicación. La cookie es creada por sp_setapprole (Transact-SQL). varbinary(8000).

Valores de código de retorno

0 (correcto) y 1 (error)

Comentarios

Tras la activación de una función de aplicación mediante sp_setapprole, la función permanece activa hasta que el usuario se desconecta del servidor o ejecuta sp_unsetapprole.

Para obtener información general acerca de las funciones de aplicación, vea Funciones de aplicación.

Permisos

Requiere la pertenencia a la función public y conocimiento de la cookie guardada cuando se activó la función de aplicación.

Ejemplos

En el siguiente ejemplo se activa la función de aplicación Sales11 con la contraseña fdsd896#gfdbfdkjgh700mM y se crea una cookie. En el ejemplo se devuelve el nombre del usuario actual y se revierte al contexto original ejecutando sp_unsetapprole.

DECLARE @cookie varbinary(8000);
EXEC sp_setapprole 'Sales11', 'fdsd896#gfdbfdkjgh700mM'
    , @fCreateCookie = true, @cookie = @cookie OUTPUT;
-- The application role is now active.
SELECT USER_NAME();
-- This will return the name of the application role, Sales11.
EXEC sp_unsetapprole @cookie;
-- The application role is no longer active.
-- The original context has now been restored.
GO
SELECT USER_NAME();
-- This will return the name of the original user. 
GO