sp_unsetapprole (Transact-SQL)

Articolo
06/18/2013

Disattiva un ruolo applicazione e ripristina il contesto di sicurezza precedente.

Icona di collegamento a un argomento Convenzioni della sintassi Transact-SQL

Sintassi

sp_unsetapprole @cookie

Argomenti

@cookie
Specifica il cookie creato al momento dell'attivazione del ruolo applicazione. Il cookie viene creato da sp_setapprole (Transact-SQL). varbinary(8000).

[!NOTA]

Il parametro OUTPUT del cookie per sp_setapprole è disponibile attualmente come varbinary(8000) che è la lunghezza massima corretta. Tuttavia, dall'implementazione corrente viene restituito varbinary(50). Le applicazioni devono continuare a riservare varbinary(8000) in modo siano in grado di funzionare correttamente se le dimensioni restituite del cookie aumentano in una versione successiva.

Valori di codice restituiti

0 (esito positivo) o 1 (esito negativo)

Osservazioni

Dopo l'attivazione di un ruolo applicazione con sp_setapprole, tale ruolo rimane attivo fino alla disconnessione dell'utente o all'esecuzione di sp_unsetapprole.

Per una panoramica dei ruoli applicazione , vedere Ruoli applicazione.

Autorizzazioni

È richiesta l'appartenenza al ruolo public ed è necessario conoscere il cookie salvato al momento dell'attivazione del ruolo applicazione.

Esempi

Nell'esempio seguente viene attivato il ruolo applicazione Sales11 con la password fdsd896#gfdbfdkjgh700mM e viene creato un cookie. L'esempio restituisce il nome dell'utente corrente e quindi ripristina il contesto originale tramite l'esecuzione di 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