srv_sendmsg (Extended Stored Procedure API)
Applies to:
SQL Server
Important
This feature will be removed in a future version of SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature. Use CLR integration instead.
Sends a message to the client.
Syntax
int srv_sendmsg (
SRV_PROC *
srvproc
,
int
msgtype
,
DBINT
msgnum
,
DBTINYINT
class
,
DBTINYINT
state
,
DBCHAR *
rpcname
,
int
rpcnamelen
,
DBUSMALLINT
linenum
,
DBCHAR *
message
,
int
msglen
);
Arguments
srvproc
Is a pointer to the SRV_PROC structure that is the handle for a particular client connection (in this case, the handle that received the language request). The structure contains information that the Extended Stored Procedure API library uses to manage communication and data between the application and the client.
msgtype
Is either SRV_MSG_INFO or SRV_MSG_ERROR, depending on whether the server is sending an informational or error message.
msgnum
Is a 4-byte message number.
class
Specifies the error severity. A severity less than or equal to 10 is considered an informational message.
state
Provides the error state number for the current message. The error state number provides information about the context of the error. Valid state numbers are from 0 through 255.
rpcname
Is currently not supported.
rpcnamelen
Is currently not supported.
linenum
Is the line number in the language command batch where the message applies. Line numbers start at 1. If linenum does not apply to the message, set to 0.
message
Is a pointer to the character string to be sent to the client.
msglen
Specifies the length, in bytes, of message. If message is null-terminated, set msglen to SRV_NULLTERM.
Returns
SUCCEED or FAIL
Remarks
This function sends error or informational messages to the client. It is called once for each message to be sent.
Messages can be sent to the client with srv_sendmsg in any order before or after all rows (if any) have been sent with srv_sendrow. All messages, if any, must be sent to the client before the completion status is sent with srv_senddone.
To send messages in Unicode, use srv_wsendmsg rather than srv_sendmsg.
For more information see Unicode Data and Server Code Pages.
Important
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.
Povratne informacije
https://aka.ms/ContentUserFeedback.
Kmalu na voljo: V letu 2024 bomo ukinili storitev Težave v storitvi GitHub kot mehanizem za povratne informacije za vsebino in jo zamenjali z novim sistemom za povratne informacije. Za več informacij si oglejte:Pošlji in prikaži povratne informacije za