sysmail_delete_profile_sp (Transact-SQL)

Articolo
12/15/2008

Data aggiornamento: 12 dicembre 2006

Elimina un profilo di posta utilizzato da Posta elettronica database.

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

Sintassi

sysmail_delete_profile_sp  { [ @profile_id = ] profile_id | [    
        @profile_name = ] 'profile_name' } 
    [, [ @force_delete = ] force_delete ]

Argomenti

[ @profile_id= ] profile_id
ID del profilo da eliminare. profile_id è di tipo int e il valore predefinito è NULL. È necessario specificare profile_id o profile_name.

[ @profile_name= ] 'profile_name'
Nome del profilo da eliminare. profile_name è di tipo sysname e il valore predefinito è NULL. È necessario specificare profile_id o profile_name.

[ @force_delete= ] force_delete
force_delete è di tipo bit. Valore predefinito = 1. Se force_delete è uguale a 1, tutti i messaggi di posta elettronica con stato unsent o retrying verranno aggiornati allo stato failed.

Se force_delete è uguale a 0 e sono presenti messaggi di posta elettronica con stato unsent o retrying, verrà generato un errore. Se non sono presenti messaggi associati, il profilo verrà eliminato.

Set di risultati

Nessuno

Osservazioni

L'eliminazione di un profilo non comporta l'eliminazione degli account utilizzati dal profilo.

Questa stored procedure elimina il profilo indipendentemente dal fatto se gli utenti abbiano o meno accesso al profilo. Prestare attenzione quando si rimuove il profilo privato predefinito di un utente o il profilo pubblico predefinito del database msdb. Quando non è disponibile alcun profilo predefinito, sp_send_dbmail richiede il nome di un profilo come argomento. Pertanto, la rimozione di un profilo predefinito potrebbe impedire l'esecuzione delle chiamate a sp_send_dbmail. Per ulteriori informazioni, vedere sp_send_dbmail (Transact-SQL).

La stored procedure sysmail_delete_profileaccount_sp si trova nel database msdb ed è di proprietà dello schema dbo. La procedura deve essere eseguita con un nome in tre parti se il database corrente non è msdb.

Autorizzazioni

Le autorizzazioni di esecuzione per questa procedura vengono assegnate per impostazione predefinita ai membri del ruolo predefinito del server sysadmin.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Esempi

Nell'esempio seguente viene eliminato il profilo AdventureWorks Administrator. In presenza di messaggi non inviati associati a questo profilo, verrà generato un errore e il profilo non verrà eliminato.

EXECUTE msdb.dbo.sysmail_delete_profile_sp
    @profile_name = N'AdventureWorks Administrator' 
    ,@force_delete = 0;

Vedere anche

Cronologia modifiche

Versione	Cronologia
12 dicembre 2006	Nuovo contenuto: Aggiunta del nuovo parametro @force_delete alle sezioni Sintassi, Argomenti ed Esempi.

Condividi tramite