sp_unsetapprole (Transact-SQL)
Désactive un rôle d'application et revient au contexte de sécurité antérieur.
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
A. Activation d'un rôle d'application avec un cookie, puis retour au contexte antérieur
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
Voir aussi
Référence
Procédures stockées système (Transact-SQL)
Procédures stockées liées à la sécurité (Transact-SQL)