xp_deletemail (Transact-SQL)
Deletes a message from the Microsoft SQL Server inbox.Procedura ta jest używana przez sp_processmail przetwarzania poczty w SQL Server Skrzynka odbiorcza.
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_deletemail { 'message_id' }
Argumenty
- 'message_id'
Is the proprietary message number (assigned by xp_findnextmsg) of the mail message in the inbox that should be deleted.message_id is varchar(255), with no default.
Wartości kodów powrotnych
0 (sukces) lub 1 (brak)
Zestawy wyników
xp_deletemail zwraca komunikat o błędzie, gdy przekazywane identyfikatora ważne wiadomości
Remarks
Niepowodzenie z wyjątkiem nieprawidłowy parametr jest rejestrowany w dzienniku aplikacji systemu Windows.
xp_deletemail usunie wiadomość ze skrzynki odbiorczej, ale nie są usuwane wszystkie załączniki z systemu plików.Należy ręcznie usunąć załączników.Generowanie załączników można pominąć, ustawiając suppress_attach Parametr dla xp_readmail na wartość TRUE.Aby uzyskać więcej informacji dotyczących problemów z zabezpieczeniami z załącznikami zobacz xp_readmail (języka Transact-SQL).
xp_deletemail nie przechowuje dziennik wiadomości usuniętych lub użytkowników, którzy usunięte wiadomości.Może to spowodować problemy z inspekcji w środowisku, w których wielu użytkowników ma uprawnienia do wykonać xp_deletemail.Aby zminimalizować ten problem, należy ograniczyć uprawnienia dla xp_deletemail członkówsysadmin stała rola serwera.
Uprawnienia
Członkostwo w grupie wymaga sysadmin stała rola serwera, ale uprawnienia wykonać może przyznane innym użytkownikom.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 identyfikator dostarczonych z wiadomości xp_findnextmsg, a następnie używa tego IDENTYFIKATORA wiadomości do usunięcia wiadomości. Wartość z xp_findnextmsg znajduje się w zmiennej lokalnej @message\_id.
DECLARE @message_id varchar(255) ;
USE master ;
EXEC xp_findnextmsg @msg_id = @message_id OUTPUT ;
EXEC xp_deletemail @message_id ;