srv_wsendmsg (Extended Stored Procedure API)

Importante:
Questa funzionalità verrà rimossa in una delle prossime versioni di Microsoft SQL Server. Non utilizzare questa funzionalità in un nuovo progetto di sviluppo e modificare appena possibile le applicazioni in cui questa funzionalità viene utilizzata. Use CLR integration instead.

Sends a Unicode message to the client.

Sintassi

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

Arguments

• srvproc
  Is a pointer to the SRV_PROC structure that is the handle for a particular client connection. The structure contains information the Extended Stored Procedure API library uses to manage communication and data between the application and the client.

• Msgnum
  Is a 4-byte message number.

• Severity
  Specifies the severity of the error. A severity less than or equal to 10 is considered an informational message; otherwise, it is an error.

• message
  Is a pointer to a Unicode string to be sent to the client.

• msglen
  Specifies the length, in characters, of message.

Returns

SUCCEED or FAIL.

Osservazioni

Use this function to send messages in Unicode. It is similar to srv_sendmsg, but the message it sends is a WCHAR string rather than type DBCHAR string. Note that message length is reported in characters rather than bytes, and msglen will never be equal to SRV_NULLTERM.

The function returns FAIL when

• The msglen given is not in the range of 0-32242.
• The msglen given is 0 but the message pointer is NULL.
• There is error when sending the error message through network.

Nota sulla protezione:
You should thoroughly review the source code of extended stored procedures, and you should test the compiled DLLs before you install them on a production server. For information about security review and testing, see this Microsoft Web site.

Vedere anche

Riferimento

srv_sendmsg (Extended Stored Procedure API)

Guida in linea e informazioni

Assistenza su SQL Server 2005