xp_findnextmsg (Transact-SQL)
Giriş için bir ileti kimliği kabul eder ve çıkış ileti Kimliğini döndürür.xp_findnextmsg ile kullanılan sp_processmail posta ile işlemek için Microsoft SQL Server gelen.
Not
Bu özellik Microsoft SQL Server'ın ilerideki bir sürümünde kaldırılacaktır. Yeni geliştirme işlerinde bu özelliği kullanmaktan kaçının ve bu özelliği kullanmakta olan uygulamalarda değişiklik yapmayı planlayın.
Sözdizimi
xp_findnextmsg [ [ @type= ] type ]
[ , [ @unread_only= ] 'unread_value' ]
[ , [ @msg_id= ] 'message_id' [ OUTPUT ] ]
Bağımsız değişkenler
[ @type=] type
ileti türü giriş MAPI tanımını temel alır:IP[M|C].Vendorname.subclass
type , null, ileti türü ile başlatmak IPM posta istemci Gelen Kutusu'nda görünür ve bulunamadı veya okuma tarafından xp_findnextmsg.İleti türleri ile başlayan IPC istemci posta gelen kutusunda görüntülenmez ve gerekir bulundu ve ayarlayarak okuma yapılabilir type parametresi.Varsayılan değer null olur.SQL Posta iletisi türlerini destekleyen IPM ve IPC.
[ @ unread_only =] 'unread_value'
İse yalnızca yoksa okunmamış (n'true') iletileri olarak kabul edilir.Varsayılan değer n'false', yani tüm iletiler değerlendirilir.unread_valuetür nvarchar(5).[ @msg_id = ] 'message_id'
Giriş ve çıkış sonraki iletide dize iletisi dize belirten bir giriş ve çıkış parametresidir.message_id Giriş, sonra varsayılan olarak, çıktı null @ msg_id gelen en son teslim edilen iletinin kimliği olacaktır.message_idİş varchar(255), varsayılan değer null.ÇIKIŞ
Belirtildiğinde, message_id bulunduğu konumdaki çıktı parametresi.Belirtilmediği durumlarda, message_id bir teksütun, tek satır sonuç kümesidöndürdü.
Dönüş Kodu Değerleri
0 (başarılı) veya 1 (hata)
Sonuç Kümeleri
xp_findnextmsg geçerli ileti kimliği geçirilen bir ileti döndürür
Zaman @ msg_id , null xp_findnextmsg aşağıdaki sonuç kümesidöndürür.
Sütun adı |
Veri türü |
Açıklama |
---|---|---|
İleti kimliği |
varchar(255) |
Sonraki iletiyi ileti kimliği. |
Açıklamalar
Geçersiz bir parametre dışında herhangi bir hata için günlüğe Microsoft Windows Uygulama günlüğünü
İzinler
Üyelik gerektiren sysadmin sabit sunucu rolüancak yürütme izinleri diğer kullanıcılara verilir.Ancak, güvenlik nedenleriyle, bu saklı yordam izinlerini üyelerine sınırlı öneririz sysadmin sabit sunucu rolü.
Örnekler
Aşağıdaki örnek, sonraki ileti kimliği (yalnızca okunmamış iletileri) ararken durumunu alır.Değeri xp_findnextmsg bulunduğu konumdaki yerel bir değişken olarak @message_id.
DECLARE @status int, @message_id varchar(255) ;
EXEC @status = xp_findnextmsg @msg_id = @message_id OUTPUT ;