srv_wsendmsg (Utökat API för lagrad procedur)

Gäller för:SQL Server

Important

Den här funktionen tas bort i en framtida version av SQL Server. Undvik att använda den här funktionen i nytt utvecklingsarbete och planera att ändra program som för närvarande använder den här funktionen. Använd istället CLR-integration.

Skickar ett Unicode-meddelande till klienten.

Syntax

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

Arguments

srvproc
Är en pekare till den SRV_PROC struktur som är handtaget för en viss klientanslutning. Strukturen innehåller information som Extended Stored Procedure API-biblioteket använder för att hantera kommunikation och data mellan applikationen och klienten.

Msgnum
Är ett 4-bytes meddelandenummer.

Severity
Specificerar felets allvar. En allvarlighetsgrad mindre än eller lika med 10 betraktas som ett informationsmeddelande; annars är det ett fel.

message
Är en pekare till en Unicode-sträng som ska skickas till klienten.

msglen
Specificerar längden, i tecken, på meddelandet.

Returns

SUCCEED eller FAIL.

Remarks

Använd denna funktion för att skicka meddelanden i Unicode. Den liknar srv_sendmsg, men meddelandet den skickar är en WCHAR-sträng snarare än en typ DBCHAR-sträng. Observera att meddelandelängden rapporteras i tecken istället för bytes, och msglen kommer aldrig att vara lika med SRV_NULLTERM.

Funktionen returnerar FAIL när

  • Den angivna mglen ligger inte i intervallet 0-32242.

  • Den givna msglen är 0 men meddelandepekaren är NULL.

  • Det uppstår fel när felmeddelandet skickas genom nätverket.

Important

Du bör noggrant granska källkoden för utökade lagrade procedurer, och du bör testa de kompilerade DLL:erna innan du installerar dem på en produktionsserver. För information om säkerhetsgranskning och testning, se denna Microsoft-webbplats.

Relaterat innehåll

  • Uppdaterades senast