Condividi tramite

  • Articolo

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.

Icona di collegamento a un argomentoConvenzioni 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.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

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.

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 ;