srv_wsendmsg (Rozszerzone API procedur przechowywanych)

Dotyczy:SQL Server

Ważna

Ta funkcja zostanie usunięta w przyszłej wersji programu SQL Server. Unikaj używania tej funkcji w nowych pracach programistycznych i zaplanuj modyfikowanie aplikacji, które obecnie korzystają z tej funkcji. Zamiast tego użyj integracji CLR.

Wysyła wiadomość Unicode do klienta.

Syntax

  
int srv_wsendmsg(SRV_PROC *   
srvproc  
, int   
msgnum  
, int   
severity  
, WCHAR *   
message  
, int   
msglen  
);

Arguments

srvproc
Jest wskaźnikiem do struktury SRV_PROC, która jest uchwytem dla konkretnego połączenia klienta. Struktura zawiera informacje, które biblioteka API Extended Stored Procedure wykorzystuje do zarządzania komunikacją i danymi między aplikacją a klientem.

Msgnum
To 4-bajtowy numer wiadomości.

Ważność
Określa stopień powagi błędu. Nasilenie mniejsze lub równe 10 jest uznawane za komunikat informacyjny; w przeciwnym razie jest to błąd.

message
To wskaźnik do ciągu Unicode, który ma zostać wysłany do klienta.

msglen
Określa długość wiadomości, wyrażoną w znakach.

Zwroty

POWODZENIE lub NIEPOWODZENIE.

Remarks

Użyj tej funkcji do wysyłania wiadomości w Unicode. Jest podobny do srv_sendmsg, ale wysyła komunikat jako ciąg WCHAR, a nie ciąg typu DBCHAR. Należy zauważyć, że długość wiadomości jest podawana w znakach, a nie bajtach, i msglen nigdy nie będzie równy SRV_NULLTERM.

Funkcja zwraca FAIL, gdy

  • Podane msglen nie mieści się w zakresie 0-32242.

  • Dane msglen to 0, ale wskaźnik wiadomości jest NULL.

  • Występuje błąd podczas wysyłania komunikatu o błędzie przez sieć.

Ważna

Powinieneś dokładnie przejrzeć kod źródłowy rozszerzonych procedur przechowywanych i przetestować skompilowane pliki DLL przed instalacją ich na serwerze produkcyjnym. Informacje o przeglądzie i testowaniu bezpieczeństwa znajdziesz na tej stronie internetowej Microsoft.

Treści powiązane

  • Last updated on