sp_unsetapprole (Transact-SQL)

Désactive un rôle d'application et revient au contexte de sécurité antérieur.

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

sp_unsetapprole @cookie 

Arguments

  • @cookie
    Spécifie le cookie créé lors de l'activation du rôle d'application. Le cookie est créé par sp_setapprole (Transact-SQL). varbinary(8000).

Valeurs du code de retour

0 (réussite) et 1 (échec)

Notes

Une fois qu'un rôle d'application est activé à l'aide de sp_setapprole, il demeure actif jusqu'à ce que l'utilisateur se déconnecte du serveur ou exécute sp_unsetapprole.

Pour une vue d'ensemble des rôles d'application , consultez Rôles d'application.

Autorisations

Requiert l'appartenance à public et la connaissance du cookie enregistré lors de l'activation du rôle d'application.

Exemples

Dans l'exemple ci-dessous, le rôle d'application Sales11 est activé avec le mot de passe fdsd896#gfdbfdkjgh700mM et un cookie est créé. L'exemple retourne le nom de l'utilisateur en cours, puis retourne au contexte d'origine en exécutant 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