sp_unsetapprole (Transact-SQL)

Article
08/19/2013

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

Icône Lien de rubrique Conventions de la syntaxe 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).

[!REMARQUE]

Le paramètre OUTPUT de cookie pour sp_setapprole est actuellement documenté comme varbinary(8000), ce qui correspond à la longueur maximale correcte. Toutefois, l'implémentation actuelle retourne varbinary(50). Les applications doivent continuer à réserver varbinary(8000) afin de continuer à fonctionner correctement si la taille de retour des cookies augmente dans une version ultérieure.

Valeurs des codes de retour

0 (succès) 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'applications.

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