Compartir a través de


srv_senddone (API de procedimiento almacenado extendido)

Nota importanteImportante

Esta característica se quitará en una versión futura de Microsoft SQL Server. No utilice esta característica en nuevos trabajos de desarrollo y modifique lo antes posible las aplicaciones que actualmente la utilizan. En su lugar, use la integración 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 usa para administrar la comunicación y los datos entre la aplicación y el cliente.

  • status
    Es un campo de 2 bytes para varios marcadores status. Varios marcadores se pueden establecer mediante los operadores lógicos AND y OR con valores de marcador status. En la tabla siguiente se enumeran los marcadores posibles status.

    Marcador de estado

    Description

    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 el marcador SRV_DONE_COUNT se establece en el campo status, count contiene un recuento válido.

Devuelve

SUCCEED o FAIL

Notas

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, el marcador 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.

Nota de seguridadNota de seguridad

Debe revisar cuidadosamente 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.