Compartir a través de


sysmail_add_profile_sp (Transact-SQL)

Crea un nuevo perfil de Correo electrónico de base de datos.

[!NOTA]

Puesto que el Correo electrónico de base de datos no utiliza la Interfaz de programación de aplicaciones de mensajería (MAPI), los perfiles de Correo electrónico de base de datos no son perfiles de correo MAPI. El Correo electrónico de base de datos no utiliza perfiles de SQL Mail.

Icono de vínculo a temasConvenciones de sintaxis de Transact-SQL

Sintaxis

sysmail_add_profile_sp [ @profile_name = ] 'profile_name'
    [ , [ @description = ] 'description' ]
    [ , [ @profile_id = ] new_profile_id OUTPUT ]

Argumentos

  • [ @profile_name = ] 'profile_name'
    Nombre del nuevo perfil. profile_name es de tipo sysname y no tiene ningún valor predeterminado.

  • [ @description = ] 'description'
    Descripción opcional del nuevo perfil. description es de tipo nvarchar(256) y no tiene ningún valor predeterminado.

  • [ @profile_id = ] new_profile_idOUTPUT
    Devuelve el Id. del nuevo perfil. new_profile_id es de tipo int y su valor predeterminado es NULL.

Valores de código de retorno

0 (correcto) o 1 (error)

Notas

Un perfil de Correo electrónico de base de datos contiene cualquier número de cuentas de Correo electrónico de base de datos. Los procedimientos almacenados de Correo electrónico de base de datos pueden hacer referencia a un perfil por el nombre o por el Id. del perfil generado por este procedimiento. Para obtener más información sobre cómo agregar una cuenta a un perfil, vea sysmail_add_profileaccount_sp (Transact-SQL).

El nombre y la descripción del perfil se pueden cambiar con el procedimiento almacenado sysmail_update_profile_sp, mientras que el Id. del perfil permanece constante mientras exista el perfil.

El nombre del perfil debe ser único para el SQL Server Database Engine (Motor de base de datos de SQL Server) de Microsoft o el procedimiento almacenado devuelve un error.

El procedimiento almacenado sysmail_add_profile_sp se encuentra en la base de datos msdb y pertenece al esquema dbo. El procedimiento se debe ejecutar con un nombre de tres partes si la base de datos actual no es msdb.

Permisos

Los permisos de ejecución para este procedimiento corresponden de forma predeterminada a los miembros de la función fija de servidor sysadmin.

Ejemplos

A. Crear un nuevo perfil

En el ejemplo siguiente se crea un nuevo perfil de Correo electrónico de base de datos denominado AdventureWorks Administrator.

EXECUTE msdb.dbo.sysmail_add_profile_sp
       @profile_name = 'AdventureWorks Administrator',
       @description = 'Profile used for administrative mail.' ;

B. Crear un nuevo perfil y guardar el Id. del perfil en una variable

En el ejemplo siguiente se crea un nuevo perfil de Correo electrónico de base de datos denominado AdventureWorks Administrator. En el ejemplo se almacena el Id. del perfil en la variable @profileId y se devuelve un conjunto de resultados que contiene el Id. del nuevo 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 ;