srv_senddone (API de procedimiento almacenado extendido)

Se aplica a:SQL Server

Importante

Esta característica se quitará en una versión futura de SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan. En su lugar, use la integración de CLR.

Envía un mensaje de finalización del resultado al cliente.

Sintaxis

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

Argumentos

srvproc
Es un puntero a la estructura SRV_PROC, que es el identificador de una conexión de cliente determinada (en este caso, el identificador que recibió la solicitud de idioma). La estructura contiene información que la biblioteca de API Procedimiento almacenado extendido utiliza para administrar la comunicación y los datos entre la aplicación y el cliente.

status
Es un campo de 2 bytes para varias marcas status . Varias marcas se pueden establecer mediante los operadores lógicos AND y OR con valores de marca status . En la tabla siguiente se enumeran las marcas posibles status .

Marca de estado	Descripción
SRV_DONE_COUNT	El parámetro count contiene un recuento válido.
SRV_DONE_ERROR	El comando de cliente actual recibió un error.

info
Es un campo reservado de 2 bytes. Establezca este valor en 0.

count
Es un campo de 4 bytes que se usa para indicar un recuento para el conjunto de resultados actual. Si la marca SRV_DONE_COUNT se establece en el campo status , count contiene un recuento válido.

Devoluciones

SUCCEED o FAIL

Comentarios

Una solicitud de cliente puede ocasionar que el servidor ejecute varios comandos y que devuelva varios conjuntos de resultados. Para cada conjunto de resultados, srv_senddone debe devolver un mensaje de finalización del resultado al cliente.

El campo count indica el número de filas afectadas por un comando. Si el campo count contiene un recuento, la marca SRV_DONE_COUNT se debería establecer en el campo status . Este valor permite al cliente distinguir entre un valor count de 0 y un campo count no usado.

No llame a srv_senddone desde el controlador SRV_CONNECT.

Importante

Debe revisar minuciosamente el código fuente de los procedimientos almacenados extendidos y debe probar las DLL compiladas antes de instalarlas en el servidor de producción. Para obtener información acerca de la revisión y pruebas de seguridad, vea este sitio web de Microsoft.