Partilhar via


sysmail_help_profile_sp (Transact-SQL)

Aplica-se a: SQL Server

Lista informações sobre um ou mais perfis de email.

Convenções de sintaxe de Transact-SQL

Sintaxe

sysmail_help_profile_sp [ [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' ]
[ ; ]

Argumentos

@profile_id [ = ] profile_id

A ID do perfil para a qual retornar informações. @profile_id é int, com um padrão de NULL.

@profile_name [ = ] 'profile_name'

O nome do perfil do qual retornar informações. @profile_name é sysname, com um padrão de NULL.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto de resultados

Retorna um conjunto de resultados com as seguintes colunas.

Nome da coluna Tipo de dados Descrição
profile_id int A ID do perfil.
name sysname O nome de perfil para o perfil.
description nvarchar(256) A descrição para o perfil.

Comentários

Quando um nome de perfil ou ID de perfil é especificado, sysmail_help_profile_sp retorna informações sobre esse perfil. Caso contrário, sysmail_help_profile_sp retornará informações sobre cada perfil na instância do SQL Server.

O procedimento sysmail_help_profile_sp armazenado está no msdb banco de dados e pertence ao esquema dbo . O procedimento deve ser executado com um nome de três partes se o banco de dados atual não msdbfor .

Permissões

Esse procedimento armazenado pertence à função db_owner . Você pode conceder EXECUTE permissões para qualquer usuário, mas essas permissões podem ser substituídas durante uma atualização do SQL Server.

Exemplos

R. Listar todos os perfis

O exemplo a seguir mostra a lista de todos os perfis na instância.

EXEC msdb.dbo.sysmail_help_profile_sp;

Conjunto de resultados de exemplo, reformatado para comprimento de linha:

profile_id  name                          description
----------- ----------------------------- ------------------------------
56          AdventureWorks Administrator  Administrative mail profile.
57          AdventureWorks Operator       Operator mail profile.

B. Listar um perfil específico

O exemplo a seguir mostra as informações de listagem para o perfil AdventureWorks Administrator.

EXEC msdb.dbo.sysmail_help_profile_sp
    @profile_name = 'AdventureWorks Administrator' ;

Conjunto de resultados de exemplo, reformatado para comprimento de linha:

profile_id  name                          description
----------- ----------------------------- ------------------------------
56          AdventureWorks Administrator  Administrative mail profile.