sysmail_add_profile_sp (Transact-SQL)
Cria um novo perfil do Database Mail.
.gif "Observação") Observação |
|---|
Como o Database Mail não usa a interface MAPI (Messaging Application Programming Interface), seus perfis não são perfis de email MAPI. O Database Mail não usa perfil do SQL Mail. |
.gif "Ícone de vínculo de tópico")
Sintaxe
sysmail_add_profile_sp [ @profile_name = ] 'profile_name'
[ , [ @description = ] 'description' ]
[ , [ @profile_id = ] new_profile_id OUTPUT ]
Argumentos
[ @profile_name = ] 'profile_name'
O nome para o novo perfil. profile_name é sysname, sem nenhum padrão.[ @description = ] 'description'
A descrição opcional para o novo perfil. description é nvarchar(256), sem nenhum padrão.[ @profile_id = ] new_profile_idOUTPUT
Retorna a ID para o novo perfil. new_profile_id é int, com um padrão NULL.
Valores de código de retorno
0 (êxito) ou 1 (falha)
Comentários
Um perfil Database Mail contém qualquer número de contas do Database Mail. Os procedimentos armazenados do Database Mail podem se referir a um perfil por meio do nome do perfil ou da identificação do perfil gerada por este procedimento. Para obter mais informações sobre como adicionar uma conta a um perfil, consulte sysmail_add_profileaccount_sp (Transact-SQL).
O nome e a descrição do perfil podem ser alterados com o procedimento armazenado sysmail_update_profile_sp, enquanto que a identificação do perfil permanece constante durante sua existência.
O nome de perfil deve ser exclusivo para o Microsoft Mecanismo de Banco de Dados do SQL Server, caso contrário o procedimento armazenado retornará um erro.
O procedimento armazenado sysmail_add_profile_sp está no banco de dados msdb e pertence ao esquema dbo. O procedimento deverá ser executado com um nome de três partes se o banco de dados atual não for msdb.
Permissões
As permissões de execução deste procedimento usam como padrão membros da função de servidor fixa sysadmin.
Exemplos
A. Criando um novo perfil
O exemplo a seguir cria um novo perfil do Database Mail chamado AdventureWorks Administrator.
EXECUTE msdb.dbo.sysmail_add_profile_sp
@profile_name = 'AdventureWorks Administrator',
@description = 'Profile used for administrative mail.' ;
B. Criando um novo perfil, salvando a identificação do perfil em uma variável
O exemplo a seguir cria um novo perfil do Database Mail chamado AdventureWorks Administrator. O exemplo armazena o número da identificação do perfil na variável @profileId e retorna um conjunto de resultados contendo o número de identificação do perfil para o novo perfil.
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 ;