Compartir a través de


xp_startmail (Transact-SQL)

Inicia una sesión de cliente de SQL Mail. Al iniciar una sesión de correo, se abren los componentes cliente MAPI y se inicia sesión en el servidor de correo electrónico.

Nota

Esta característica se quitará en una versión futura de Microsoft SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan.

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

Sintaxis

xp_startmail [ [ @user= ] 'mapi_profile_name' ]
     [ , [ @password= ] 'mapi_profile_password' ] 

Argumentos

  • [ @user = ] 'mapi_profile_name'
    Es un parámetro opcional que especifica un nombre de perfil de correo. mapi_profile_name es de tipo sysname y no tiene ningún valor predeterminado. Si no se proporciona este parámetro, se utiliza la configuración predeterminada de Microsoft Outlook.

  • [ @password = ] 'mapi_profile_password'
    Es la contraseña de correo para el mapi_profile_name especificado. mapi_profile_password es de tipo sysname y no tiene ningún valor predeterminado. Se permite el valor NULL cuando el cliente de correo se inicia (en el mismo equipo) antes de ejecutar xp_startmail.

Valores de código de retorno

0 (correcto) o 1 (error)

Conjuntos de resultados

xp_startmail devuelve este mensaje:

SQL mail session started.

Comentarios

Si se proporcionan mapi_profile_name y mapi_profile_password, SQL Server intenta iniciar una sesión en el proveedor MAPI utilizando el nombre y la contraseña de ese perfil. Si se proporcionan mapi_profile_name y mapi_profile_password pero son incorrectos, se devuelve un mensaje de error. Si no se proporcionan mapi_profile_name y mapi_profile_password, SQL Server utiliza el nombre y la contraseña del perfil especificados en el cuadro de diálogo Configuración de SQL Mail. Si no se proporcionan un nombre y una contraseña de perfil de manera explícita, SQL Server intenta iniciar sesión en el proveedor MAPI utilizando el perfil MAPI predeterminado. Algunos proveedores MAPI se pueden configurar para utilizar la autenticación de Windows, en cuyo caso se omite la contraseña para MAPI.

Nota

Si utiliza xp_startmail para iniciar sesiones de correo, puede proporcionar opcionalmente su nombre y contraseña de inicio de sesión para no tener que escribirlos en el símbolo del sistema. Sin embargo, SQL Mail no se ejecutará sobre una sesión MAPI existente si hay alguna ejecutándose. Este comportamiento difiere de SQL Server 7.0 y anteriores.

Si hay una sesión de correo existente, xp_startmail no inicia una nueva. Si se está utilizando el correo en el mismo equipo en el que se está ejecutando SQL Server, se debe iniciar el cliente de correo antes de ejecutar xp_startmail o antes de iniciar SQL Server si SQL Mail está configurado para iniciarse automáticamente cuando se inicia SQL Server.

Permisos

Debe pertenecer a la función fija de servidor sysadmin, pero se pueden conceder permisos EXECUTE a otros usuarios. Sin embargo, por razones de seguridad, se recomienda limitar los permisos para este procedimiento almacenado a los miembros de la función fija de servidor sysadmin.

Ejemplos

En el ejemplo siguiente se inicia el correo utilizando el nombre de usuario y la contraseña especificados en Microsoft Outlook como perfil predeterminado para la cuenta de Microsoft Windows con la que se ejecuta SQL Server.

USE master;
GO
EXEC xp_startmail;
GO