• Article

xp_findnextmsg (Transact-SQL)

Accepte un ID de message en entrée et retourne l'ID de message en sortie. xp_findnextmsg s'utilise avec sp_processmail pour le traitement du courrier de la boîte de réception Microsoft SQL Server.

Notes

Cette fonctionnalité sera supprimée dans une prochaine version de Microsoft SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité.

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

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

Arguments

  • [ @type=] type
    Type de message d'entrée basé sur la définition MAPI :

    IP[M|C].Vendorname.subclass

    Si type a la valeur NULL, les types de messages commençant par IPM apparaissent dans la boîte de réception du client de messagerie et sont retrouvés ou lus par xp_findnextmsg. Les types de messages commençant par IPC n'apparaissent pas dans la boîte de réception du client de messagerie et doivent être recherchés ou lus en définissant le paramètre type. La valeur par défaut est NULL. SQL Mail prend en charge les messages de type IPM et IPC.

  • [ @unread_only=] 'unread_value'
    Indique si seuls les messages non lus (N'TRUE') sont pris en compte. La valeur par défaut est N'FALSE', ce qui indique que tous les messages sont pris en compte. unread_value est de type nvarchar(5).

  • [ @msg_id=] 'message_id'
    Paramètre d'entrée et de sortie qui spécifie la chaîne du message en entrée et la chaîne du message suivant en sortie. Si la valeur de message_id en entrée est NULL, par défaut, la sortie @msg_id aura la valeur de l'ID du dernier message à avoir été remis dans la boîte de réception. message_id est de type varchar(255), avec NULL comme valeur par défaut.

  • OUTPUT
    Lorsque cet argument est spécifié, message_id est placé dans le paramètre de sortie. Lorsqu'il est omis, message_id est retourné sous forme de jeu de résultats d'une seule colonne et d'une seule ligne.

Valeurs des codes renvoyés

0 (succès) ou 1 (échec)

Jeux de résultats

xp_findnextmsg retourne un message lorsqu'un ID de message valide lui est transmis.

Lorsque la valeur de @msg_id est NULL, xp_findnextmsg retourne le jeu de résultats suivant.

Nom de colonne

Type de données

Description

Message ID

varchar(255)

Identificateur du message suivant.

Notes

Tout échec à l'exception d'un paramètre non valide est connecté au journal de l'application Microsoft Windows.

Autorisations

Nécessite l'appartenance au rôle de serveur fixe sysadmin, mais les autorisations EXECUTE peuvent être accordées à d'autres utilisateurs. Cependant, pour des raisons de sécurité, nous vous conseillons de limiter les autorisations pour cette procédure stockée aux membres du rôle de serveur fixe sysadmin.

Exemple

L'exemple suivant récupère l'état lorsqu'il recherche l'ID du message suivant (des messages non lus uniquement). La valeur provenant de xp_findnextmsg est placée dans la variable locale @message_id.

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

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