srv_senddone (Extended Stored Procedure API)

ms164688.note(zh-cn,SQL.90).gif重要提示:
后续版本的 Microsoft SQL Server 将删除该功能。请不要在新的开发工作中使用该功能,并尽快修改当前还在使用该功能的应用程序。 Use CLR integration instead.

Sends a result completion message to the client.

语法


int srv_senddone (
SRV_PROC *
srvproc
,
DBUSMALLINT 
status
,
DBUSMALLINT
info
,
DBINT
count 
);

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.
  • status
    Is a 2-byte field for various status flags. Multiple flags can be set by using the AND and OR logical operators with status flag values. The following table lists possible status flags.

    Status flag Description

    SRV_DONE_COUNT

    The count parameter contains a valid count.

    SRV_DONE_ERROR

    The current client command received an error.

  • info
    Is a reserved, 2-byte field. Set this value to 0.
  • count
    Is a 4-byte field used to indicate a count for the current result set. If the SRV_DONE_COUNT flag is set in the status field, count holds a valid count.

Returns

SUCCEED or FAIL

备注

A client request can cause the server to execute a number of commands and to return a number of result sets. For each result set, srv_senddone must return a result completion message to the client.

The count field indicates the number of rows affected by a command. If the count field contains a count, the SRV_DONE_COUNT flag should be set in the status field. This setting allows the client to distinguish between a count value of 0 and an unused count field.

Do not call srv_senddone from the SRV_CONNECT handler.

ms164688.security(zh-cn,SQL.90).gif安全说明:
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.