sysmail_delete_principalprofile_sp (Transact-SQL)

Actualizado: 12 de diciembre de 2006

Quita el permiso de un usuario de la base de datos msdb o de la función public para usar un perfil público o privado de Correo electrónico de base de datos.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sysmail_delete_principalprofile_sp  { [ @principal_id = ] principal_id | [ @principal_name = ] 'principal_name' } ,
    { [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' }

Argumentos

• [ @principal_id = ] principal_id
  Es el identificador del usuario de la base de datos msdb o 0 para la función public. principal_id es de tipo int y tiene el valor predeterminado NULL. Para convertir un perfil público en un perfil privado, debe proporcionar el Id. de la entidad de seguridad 0 o el nombre de la entidad de seguridad 'public'. Debe especificarse principal_id o principal_name.

• [ @principal_name = ] 'principal_name'
  Es el nombre del usuario de la base de datos msdb o 'public' para la función public. principal_name es de tipo sysname y tiene el valor predeterminado NULL. Para convertir un perfil público en un perfil privado, debe proporcionar el Id. de la entidad de seguridad 0 o el nombre de la entidad de seguridad 'public'. Debe especificarse principal_id o principal_name.

• [ @profile_id = ] profile_id
  Es el Id. del perfil para la asociación 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 para la asociación que se va a eliminar. profile_name es de tipo sysname y su valor predeterminado es NULL. Debe especificarse profile_id o profile_name.

Notas

Para convertir un perfil público en un perfil privado, debe proporcionar 'public' para el nombre de la entidad de seguridad o 0 para el Id. de la entidad de seguridad.

Tenga cuidado al quitar permisos para el perfil privado predeterminado de un usuario o el perfil público predeterminado. 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_principalprofile_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 de la asociación entre el perfil AdventureWorks Administrator y el inicio de sesión ApplicationUser de la base de datos msdb.

EXECUTE msdb.dbo.sysmail_delete_principalprofile_sp
    @principal_name = 'ApplicationUser',
    @profile_name = 'AdventureWorks Administrator' ;

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

Versión	Historial
12 de diciembre de 2006	Contenido modificado: Se ha aclarado que los usuarios son usuarios de msdb y que la función se limita a public.