接受輸入的郵件ID 并返回輸出的郵件ID。為了處理 Microsoft® SQL Server™ 收件箱中的郵件,請一起使用 xp_findnextmsg 和 sp_processmail。
xp_findnextmsg [[@type =] type]
[,[@unread_only =] 'unread_value']
[,[@msg_id =] 'message_number' [OUTPUT]]
[@type =] type
是基于以下 MAPI 郵件定義的輸入郵件類型:
IP[M | C].Vendorname.subclass
如果 type 為 NULL,則以 IPM 打頭的郵件類型出現(xiàn)在郵件客戶程序的收件箱中,可通過 xp_findnextmsg 查找或閱讀。以 IPC 打頭的郵件類型不出現(xiàn)在郵件客戶程序的收件箱中,并且必須設(shè)置 type 參數(shù)才能查找或閱讀。默認設(shè)置為 NULL。
[@unread_only =] 'unread_value'
是否僅考慮未讀 (true) 郵件。默認值為 FALSE,即考慮所有郵件。
[@msg_id =] 'message_number'
是輸入和輸出參數(shù),輸入時指定郵件字符串,輸出時指定下一封郵件的字符串。
OUTPUT
如果指定,message_number 將置于輸出參數(shù)中。如果未指定,message_number 將作為單列、單行結(jié)果集返回。
0(成功)或 1(失?。?/P>
當所傳遞的郵件ID 有效時,xp_findnextmsg 返回下列結(jié)果集:
The command(s) completed successfully.
除無效參數(shù)外的任何失敗均記入 Microsoft Windows NT® 應(yīng)用程序日志。
xp_findnestmsg 的執(zhí)行權(quán)限默認授予 master 數(shù)據(jù)庫中的 db_owner 固定數(shù)據(jù)庫角色成員以及 sysadmin 固定服務(wù)器角色成員,但可以授予其他用戶。
下例在搜索下一個郵件 ID(僅搜索未讀郵件)時檢索狀態(tài)。xp_findnextmsg 返回的值將置于局部變量 @message_id 中。
DECLARE @status int, @message_id varchar(255)
-- SET @status = value would be here.
-- SET @message_id = value would be here.
EXEC @status = xp_findnextmsg @msg_id = @message_id OUTPUT
相關(guān)文章