sysmail_delete_profile_sp (Transact-SQL)

Actualizado: 12 de diciembre de 2006

Elimina un perfil de correo del Correo electrónico de base de datos.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sysmail_delete_profile_sp  { [ @profile_id = ] profile_id | [    
        @profile_name = ] 'profile_name' } 
    [, [ @force_delete = ] force_delete ]

Argumentos

• [ @profile_id= ] profile_id
  Es el Id. del perfil que se va a eliminar. profile_id es de tipo int y su valor predeterminado es NULL. Debe especificarse profile_id o profile_name.

• [ @profile_name= ] 'profile_name'
  Es el nombre del perfil que se va a eliminar. profile_namej es de tipo sysname y su valor predeterminado es NULL. Debe especificarse profile_id o profile_name.

• [ @force_delete= ] force_delete
  force_delete es de tipo bit. Valor predeterminado = 1. Si force_delete es igual a 1, cualquier mensaje de correo electrónico que tenga el estado sin enviar o reintentando se actualizará a error.

  Si force_delete es igual a 0 y algún mensaje de correo electrónico tiene el estado sin enviar o reintentando, se generará un error o, si no hay ningún mensaje asociado, se eliminará el perfil.

Conjuntos de resultados

Ninguno

Notas

La eliminación de un perfil no elimina las cuentas utilizadas por dicho perfil.

Este procedimiento almacenado elimina el perfil independientemente de si otros usuarios tienen acceso a él. Tenga cuidado al quitar el perfil privado predeterminado de un usuario o el perfil público predeterminado de la base de datos msdb. Si no hay ningún perfil predeterminado disponible, sp_send_dbmail necesita el nombre de un perfil como argumento. Por consiguiente, quitar un perfil predeterminado puede hacer que las llamadas a sp_send_dbmail no se realicen correctamente. Para obtener más información, vea sp_send_dbmail (Transact-SQL).

El procedimiento almacenado sysmail_delete_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.

Valores de código de retorno

0 (correcto) o 1 (error)

Ejemplos

En el siguiente ejemplo se muestra la eliminación del perfil llamado AdventureWorks Administrator. Si hay mensajes sin enviar asociados a este perfil, se generará un error y el perfil no se eliminará.

EXECUTE msdb.dbo.sysmail_delete_profile_sp
    @profile_name = N'AdventureWorks Administrator' 
    ,@force_delete = 0;

Vea también

Referencia

Procedimientos almacenados de Correo electrónico de base de datos y SQL Mail (Transact-SQL)

Otros recursos

Correo electrónico de base de datos
Perfiles del Correo electrónico de base de datos
Seleccionar tarea de configuración (Correo electrónico de base de datos)

Ayuda e información

Obtener ayuda sobre SQL Server 2005

Historial de cambios