sp_unsetapprole (Transact-SQL)sp_unsetapprole (Transact-SQL)

Se aplica a:Applies to: síSQL ServerSQL Server (todas las versiones admitidas) yesSQL ServerSQL Server (all supported versions) Se aplica a:Applies to: síSQL ServerSQL Server (todas las versiones admitidas) yesSQL ServerSQL Server (all supported versions)

Desactiva un rol de aplicación y vuelve al contexto de seguridad anterior.Deactivates an application role and reverts to the previous security context.

Icono de vínculo de tema Convenciones de sintaxis de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxisSyntax

  
sp_unsetapprole @cookie   

ArgumentosArguments

@ellas@cookie
Especifica la cookie que se creó cuando se activó el rol de aplicación.Specifies the cookie that was created when the application role was activated. La cookie se crea mediante sp_setapprole ()de Transact-SQL .The cookie is created by sp_setapprole (Transact-SQL). varbinary (8000).varbinary(8000).

Nota

El parámetro OUTPUT de la cookie para sp_setapprole está documentado actualmente como varbinary(8000) , que es la longitud máxima correcta.The cookie OUTPUT parameter for sp_setapprole is currently documented as varbinary(8000) which is the correct maximum length. Pero la implementación actual devuelve varbinary(50) .However the current implementation returns varbinary(50). Las aplicaciones deben seguir reservando varbinary (8000) para que la aplicación siga funcionando correctamente si el tamaño de retorno de la cookie aumenta en una versión futura.Applications should continue to reserve varbinary(8000) so that the application continues to operate correctly if the cookie return size increases in a future release.

Valores de código de retornoReturn Code Values

0 (correcto) y 1 (error)0 (success) and 1 (failure)

ObservacionesRemarks

Después de activar un rol de aplicación mediante sp_setapprole, el rol permanece activo hasta que el usuario se desconecta del servidor o ejecuta sp_unsetapprole.After an application role is activated by using sp_setapprole, the role remains active until the user either disconnects from the server or executes sp_unsetapprole.

Para obtener información general sobre los roles de aplicación, consulte roles de aplicación.For an overview of application roles, see Application Roles.

PermisosPermissions

Requiere la pertenencia al público y el conocimiento de la cookie guardada cuando se activó el rol de aplicación.Requires membership in public and knowledge of the cookie saved when the application role was activated.

EjemplosExamples

En el siguiente ejemplo se habilita el rol de aplicación Sales11 con la contraseña fdsd896#gfdbfdkjgh700mM y se crea una cookie.The following example activates the Sales11 application role with password fdsd896#gfdbfdkjgh700mM, and creates a cookie. En el ejemplo se devuelve el nombre del usuario actual y, a continuación, se revierte al contexto original ejecutando sp_unsetapprole.The example returns the name of the current user, and then reverts to the original context by executing 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   

Consulte tambiénSee Also

sp_setapprole (Transact-SQL) sp_setapprole (Transact-SQL)
Procedimientos almacenados del sistema (Transact-SQL) System Stored Procedures (Transact-SQL)
Procedimientos almacenados de seguridad (Transact-SQL) Security Stored Procedures (Transact-SQL)
CREATE APPLICATION ROLE (Transact-SQL) CREATE APPLICATION ROLE (Transact-SQL)
DROP APPLICATION ROLE (Transact-SQL)DROP APPLICATION ROLE (Transact-SQL)