Partilhar via


sysmail_help_profile_sp (Transact-SQL)

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

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

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

Argumentos

  • [ @profile_id = ] profile_id
    A ID de perfil à qual as informações são retornadas. profile_id é int, com um padrão NULL.

  • [ @profile_name = ] 'profile_name'
    O nome do perfil ao qual as informações são retornadas. profile_name é sysname, com um padrão 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.

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 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          AdventureWorks2008R2 Administrator  Administrative mail profile.  
57          AdventureWorks2008R2 Operator       Operator mail profile.        

B. Listando um perfil específico

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

EXECUTE msdb.dbo.sysmail_help_profile_sp
    @profile_name = 'AdventureWorks2008R2 Administrator' ;

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

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