xp_findnextmsg (Transact-SQL)

Acepta un Id. de mensaje como entrada y devuelve el Id. de mensaje como salida. xp_findnextmsg se utiliza con sp_processmail para procesar correo en la bandeja de entrada de Microsoft SQL Server.

[!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.

Convenciones de sintaxis de Transact-SQL

Sintaxis

xp_findnextmsg [ [ @type= ] type ] 
     [ , [ @unread_only= ] 'unread_value' ]
     [ , [ @msg_id= ] 'message_id' [ OUTPUT ] ]

Argumentos

• [ @type=] type
  Es el tipo de mensaje de entrada basado en la definición MAPI:

  IP[M|C].Vendorname.subclass

  Si type es NULL, los tipos de mensajes que comienzan por IPM aparecen en la bandeja de entrada del cliente de correo y xp_findnextmsg los podrá buscar y leer. Los tipos de mensajes que empiezan por IPC no aparecen en la bandeja de entrada del cliente de correo y se tienen que buscar o leer estableciendo el parámetro type. El valor predeterminado es NULL. SQL Mail admite los tipos de mensajes IPM e IPC.

• [ @unread_only=] 'unread_value'
  Indica si sólo se consideran los mensajes no leídos (N'TRUE'). El valor predeterminado es N'FALSE', lo que significa que todos los mensajes se tienen en cuenta. unread_value es de tipo nvarchar(5).

• [ @msg_id=] 'message_id'
  Es un parámetro de entrada y salida que especifica la cadena del mensaje como entrada y la cadena del mensaje siguiente como salida. Si message_id es NULL para la entrada, de forma predeterminada el @msg_id de salida es el Id. del último mensaje entregado en la bandeja de entrada. message_id es de tipo varchar(255) y su valor predeterminado es NULL.

• OUTPUT
  Cuando se especifica, message_id se devuelve como el parámetro de salida. Cuando no se especifica, message_id se devuelve como un conjunto de resultados de una sola fila y una sola columna.

Conjuntos de resultados

xp_findnextmsg devuelve un mensaje cuando recibe un Id. de mensaje válido.

Si @msg_id es NULL, xp_findnextmsg devuelve el siguiente conjunto de resultados.

Nombre de columna	Tipo de datos	Descripción
Id. del mensaje	varchar(255)	Id. de mensaje del siguiente mensaje.

Notas

Cualquier error, excepto un parámetro no válido, queda registrado en el registro de aplicación de Microsoft Windows.

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.

Valores de código de retorno

0 (correcto) o 1 (error)

Ejemplos

En el ejemplo siguiente se obtiene el estado cuando se busca el siguiente Id. de mensaje (sólo para los mensajes no leídos). El valor de xp_findnextmsg se coloca en la variable local @message_id.

DECLARE @status int, @message_id varchar(255) ;

EXEC @status = xp_findnextmsg @msg_id = @message_id OUTPUT ;

Vea también

Referencia

sp_processmail (Transact-SQL)
Procedimientos almacenados del sistema (Transact-SQL)
xp_deletemail (Transact-SQL)
xp_readmail (Transact-SQL)
xp_sendmail (Transact-SQL)
xp_startmail (Transact-SQL)
xp_stopmail (Transact-SQL)

Ayuda e información

Obtener ayuda sobre SQL Server 2005