xp_findnextmsg (języka 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.
Uwaga
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.
.gif "Topic link icon")
xp_findnextmsg [ [ @type= ] type ]
[ , [ @unread_only= ] 'unread_value' ]
[ , [ @msg_id= ] 'message_id' [ OUTPUT ] ]
Argumenty
[ @type=] type
Typ komunikatu wejściowego jest oparty na definicji interfejsu MAPI:IP[M|C].Vendorname.subclass
Jeśli type ma wartość NULL, typy wiadomości, które zaczynają się IPM pojawia się w Skrzynce odbiorczej z klient poczty i są znalezione i czytane przez xp_findnextmsg.Typy wiadomości, które zaczynają się IPC nie są wyświetlane w Skrzynce odbiorczej z klient poczty i muszą być znalezione lub odczytu, ustawiając type parametr. Wartość domyślna jest równa NULL.Poczta SQL obsługuje typy wiadomości IPM i IPC.
[ @unread_only=] 'unread_value'
Czy czy tylko nieprzeczytane ()N'TRUE ") wiadomości są uważane za.The default is N'FALSE', which means all messages are considered.unread_value is of type nvarchar(5).[ @msg_id=] 'message_id'
Jest parametrem wejściowe i wyjściowe, które określa ciąg znaków, wiadomości na dane wejściowe i ciągu następnej wiadomości na wyjściu.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.DANE WYJŚCIOWE
Po określeniu message_id jest umieszczana w parametru wyjściowego. Jeśli nie jest określona, message_id są zwracane jako zestaw wyników jednokolumnową, pojedynczy wiersz.
Wartości kodów powrotnych
0 (sukces) lub 1 (brak)
Zestawy wyników
xp_findnextmsg zwraca komunikat o błędzie, gdy przekazywane identyfikatora ważne wiadomości
Kiedy @ msg_id is NULL, xp_findnextmsg zwraca następujący zestaw wyników.
Nazwa kolumna |
Typ danych |
Description |
|---|---|---|
Identyfikator komunikatu |
varchar(255) |
Identyfikator wiadomości do następnej wiadomości. |
Remarks
Niepowodzenie z wyjątkiem nieprawidłowy parametr jest rejestrowany z Microsoft W dzienniku aplikacji systemu Windows.
Uprawnienia
Członkostwo w grupie wymaga sysadmin ustalić roli serwera, ale inni użytkownicy mogą być przyznane uprawnienia wykonać.Ze względów bezpieczeństwa zaleca się jednak że uprawnienia dla tej procedura przechowywana jest ograniczona do członków sysadmin ustalić roli serwera.
Przykłady
Poniższy przykład pobiera stan podczas wyszukiwania następnej identyfikator wiadomości (w przypadku tylko nieprzeczytane wiadomości).Wartość z xp_findnextmsg znajduje się w zmiennej lokalnej @message\_id.
DECLARE @status int, @message_id varchar(255) ;
EXEC @status = xp_findnextmsg @msg_id = @message_id OUTPUT ;