xp_findnextmsg (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.

Valores de código de retorno

0 (correcto) o 1 (error)

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.

Comentarios

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.

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