Share via

  • Artykuł

xp_findnextmsg (języka Transact-SQL)

Akceptuje identyfikator wiadomości do wprowadzania danych i zwraca identyfikator wiadomości dla danych wyjściowych.xp_findnextmsg z sp_processmail do przetwarzania poczty w Microsoft SQL Server skrzynki odbiorczej.

Ostrzeżenie

Ta funkcja zostanie usunięta z przyszłej wersji programu Microsoft SQL Server. Należy unikać stosowania tej funkcji w nowych projektach oraz zaplanować modyfikację aplikacji, w których obecnie jest używana ta funkcja.

Ikona łącza do tematuJęzyka Transact-SQL składni konwencje

Składnia

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

Argumenty

  • [ @type=] type
    typ komunikatu danych wejściowych opiera się na definicji MAPI :

    IP[M|C].Vendorname.subclass

    Jeśli type ma wartość NULL, typy wiadomości, które zaczynają IPM są wyświetlane w Skrzynce odbiorczej poczty klient i są znalezione i czytane przez xp_findnextmsg.Typy, które rozpoczynają się od IPC nie są wyświetlane w Skrzynce odbiorczej poczty klient i muszą być znalezione lub odczytu poprzez ustawienie type parametru.Wartością domyślną jest NULL.SQL Mail obsługuje typy wiadomości IPM i IPC.

  • [ @ unread_only =] 'unread_value"
    Jest czy tylko nieprzeczytane (N'TRUE ") są traktowane jako wiadomości.Wartością domyślną jest N'FALSE ", co oznacza wszystkie wiadomości są uważane za.unread_valueTyp jest nvarchar(5).

  • [ @msg_id = ] 'message_id'
    Jest parametrem wejściowe i wyjściowe Określa ciąg wiadomości na wejściu i ciąg następnej wiadomości na wyjściu.Jeśli message_id dla danych wejściowych jest NULL, następnie domyślnie, dane wyjściowe @ msg_id zawiera identyfikator niedawno dostarczonych wiadomości w Skrzynce odbiorczej.message_idjest varchar(255), domyślna wartość NULL.

  • DANE WYJŚCIOWE
    Po określeniu message_id jest umieszczana w parametru wyjściowego.Gdy nie został określony, message_id są zwracane jako jedno -kolumna, pojedynczego wiersza, zestaw wyników.

Wartości kodów powrotnych

0 (sukces) lub 1 (błąd)

Zestawy wyników

xp_findnextmsg zwraca komunikat, gdy przekazany identyfikator ważne wiadomości.

Gdy @ msg_id ma wartość NULL, xp_findnextmsg zwraca następujące zestaw wyników.

Nazwa kolumny

Typ danych

Opis

Identyfikator komunikatu

varchar(255)

Identyfikator wiadomości do następnej wiadomości.

Uwagi

Niepowodzenie z wyjątkiem nieprawidłowy parametr jest zalogowany do Microsoft informacje aplikacji systemu Windows

Uprawnienia

Wymaga członkostwa w sysadmin stała rola serwera, ale uprawnienia wykonywania mogą być przyznane innym użytkownikom.Jednak ze względów bezpieczeństwa zalecane jedynie uprawnienia dla tej procedura składowana dla członków sysadmin stała rola serwera.

Przykłady

Poniższy przykład pobiera stan podczas wyszukiwania następnej wiadomości identyfikator (tylko nieprzeczytane wiadomości).Wartość z xp_findnextmsg jest umieszczana w zmiennej lokalnej @message_id.

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

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