Partilhar via


sysmail_help_profile_sp (Transact-SQL)

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

Ícone de vínculo de tópico Convenções da sintaxe Transact-SQL

Sintaxe

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

Argumentos

  • [ @profile_id = ] profile_id
    A id do perfil do 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 de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Retorna um conjunto de resultados com as seguintes colunas.

Nome da coluna

Tipo de dados

Descrição

profile_id

int

A ID de perfil para o perfil.

nome

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 uma ID de perfil são especificados, sysmail_help_profile_sp retorna informações sobre esse perfil. Caso contrário, sysmail_help_profile_sp retorna informações sobre todo perfil na instância do SQL Server.

O procedimento armazenado sysmail_help_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. Listando todos os perfis

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

EXECUTE 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. Listando um perfil específico

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

EXECUTE 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.  

Consulte também

Referência

Procedimentos armazenados do Database Mail (Transact-SQL)

Conceitos

Database Mail