Aracılığıyla paylaş

  • Makale

xp_findnextmsg (Transact-SQL)

Accepts a message ID for input and returns the message ID for output.xp_findnextmsg is used with sp_processmail in order to process mail in the Microsoft SQL Server inbox.

Not

This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

Topic link iconTransact-SQL sözdizimi kuralları

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

Bağımsız değişkenler

  • [ @type=] type
    Giriş iletisi türü MAPI tanımına göre:

    IP[M|C].Vendorname.subclass

    If type null, ile başlayan bir ileti türleri IPM Gelen posta kutusunda görünen istemci ve bulunamadı veya okunan xp_findnextmsg.Ile başlayan bir ileti türleri IPC posta istemcisinin gelen kutusunda görünmez ve olmalı bulunamadı veya ayarlayarak okuma type parametre. Varsayılan değer NULL olur.SQL Mail ileti türlerini destekler. IPM ve IPC.

  • [ @unread_only=] 'unread_value'
    Mı yoksa yalnızca okunmamış (n'true ') iletileri kabul edilir.The default is N'FALSE', which means all messages are considered.unread_value is of type nvarchar(5).

  • [ @msg_id=] 'message_id'
    Giriş ve çıkış sonraki iletide dizenin iletinin dizesini belirten bir giriş ve çıkış parametresi olarak belirtilir.If message_id for the input is NULL, then by default, the output @msg_id will be the ID for the most recently delivered message in the Inbox.message_id is varchar(255), with a default of NULL.

  • ÇIKIŞ
    Belirtilen zaman message_id Çıkış parametresi yerleştirilir. Belirtilmediği durumlarda message_id tek sütunlu, tek satırlık bir sonucu olarak döndürülen küme.

Dönüş Kodu Değerleri

0 (başarılı) veya 1 (hata)

Sonuç Kümeleri

xp_findnextmsg bir geçerli ileti KIMLIğI sırasında bir ileti verir...

Ne zaman @ msg_id is NULL, xp_findnextmsg aşağıdaki sonuç kümesi verir.

Sütun adı

Veri türü

Açıklama

Ileti KIMLIĞI

varchar(255)

Sonraki iletinin ileti KIMLIĞI.

Remarks

Geçersiz bir parametre dışında herhangi bir hata günlüğe kaydediliyor Microsoft Windows Uygulama günlüğüne.

İzinler

Üyelik gerektirir sysadmin sabit sunucu rolü, ancak yürütmek izinleri, diğer kullanıcılar için verilebilir.Ancak, güvenlik nedenleriyle Bu saklı yordam için izinleri üyelerine sınırlı olmasını öneririz sysadmin sabit sunucu rolü.

Örnekler

Aşağıdaki örnek, sonraki ileti KIMLIĞI (yalnızca okunmamış iletiler için) ararken durumunu alır.Değeri xp_findnextmsg yerel değişken olarak verilen @message\_id.

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

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