sysmail_add_profile_sp (Transact-SQL)
Crea un nuovo profilo di Posta elettronica database.
[!NOTA] Poiché Posta elettronica database non utilizza MAPI (Messaging Application Programming Interface) i profili di Posta elettronica database non sono profili MAPI. Posta elettronica database non utilizza i profili SQL Mail.
.gif "Icona di collegamento a un argomento")
Convenzioni della sintassi Transact-SQL
Sintassi
sysmail_add_profile_sp [ @profile_name = ] 'profile_name'
[ , [ @description = ] 'description' ]
[ , [ @profile_id = ] new_profile_id OUTPUT ]
Argomenti
- [ @profile_name = ] 'profile_name'
Nome del nuovo profilo. profile_name è di tipo sysname e non prevede alcun valore predefinito.
- [ @description = ] 'description'
Descrizione facoltativa del nuovo profilo. description è di tipo nvarchar(256) e non prevede alcun valore predefinito.
- [ @profile_id = ] new_profile_idOUTPUT
Restituisce l'ID del nuovo profilo. new_profile_id è di tipo int e il valore predefinito è NULL.
Osservazioni
Un profilo di Posta elettronica database include qualsiasi numero di account di Posta elettronica database. Le stored procedure di Posta elettronica database possono far riferimento a un profilo attraverso il nome del profilo o l'ID del profilo generato da questa procedura. Per ulteriori informazioni sull'aggiunta di un account a un profilo, vedere sysmail_add_profileaccount_sp (Transact-SQL).
Il nome e la descrizione del profilo possono essere modificati tramite la stored procedure sysmail_update_profile_sp, mentre l'ID del profilo resta invariato per tutta la durata del profilo.
Il nome del profilo deve essere univoco per Microsoft Motore di database di SQL Server. In caso contrario, la stored procedure restituisce un errore.
La stored procedure sysmail_add_profile_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
A. Creazione di un nuovo profilo
Nell'esempio seguente viene creato un nuovo profilo di Posta elettronica database denominato AdventureWorks Administrator.
EXECUTE msdb.dbo.sysmail_add_profile_sp
@profile_name = 'AdventureWorks Administrator',
@description = 'Profile used for administrative mail.' ;
B. Creazione di un nuovo profilo e salvataggio dell'ID del profilo in una variabile
Nell'esempio seguente viene creato un nuovo profilo di Posta elettronica database denominato AdventureWorks Administrator. Nell'esempio il numero di ID del profilo viene archiviato nella variabile @profileId e viene restituito un set di risultati contenente il numero di ID del nuovo profilo.
DECLARE @profileId INT ;
EXECUTE msdb.dbo.sysmail_add_profile_sp
@profile_name = 'AdventureWorks Administrator',
@description = 'Profile used for administrative mail.',
@profile_id = @profileId OUTPUT ;
SELECT @profileId ;
Vedere anche
Riferimento
Stored procedure di Posta elettronica database e SQL Mail (Transact-SQL)
Altre risorse
Posta elettronica database
Account di Posta elettronica database
Profili di Posta elettronica database
Selezione attività di configurazione (Posta elettronica database)