srv_senddone (API-интерфейс расширенных хранимых процедур)

Статья
05/30/2023

Применимо к:SQL Server

Внимание

Эта функция будет удалена в будущей версии SQL Server. Избегайте использования этого компонента в новых разработках и запланируйте изменение существующих приложений, в которых он применяется. Пользуйтесь вместо этого интеграцией со средой CLR.

Передает клиенту сообщение о результатах завершения.

Синтаксис

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

Аргументы

srvproc
Указатель на структуру SRV_PROC, который представляет собой дескриптор соединения с клиентом (в данном случае — дескриптор, который получил запрос языка). Структура содержит сведения, которые используются библиотекой API-интерфейса расширенных хранимых процедур для управления связью и передачи данных между приложением и клиентом.

состояние
Представляет собой двухбайтовое поле для различных флагов status . С помощью логических операторов И и ИЛИ можно задавать сразу несколько флагов status . В следующей таблице перечислены возможные флаги status .

Флаг состояния	Description
SRV_DONE_COUNT	Параметр count содержит допустимое значение счетчика.
SRV_DONE_ERROR	Текущая клиентская команда получила ошибку.

info
Зарезервированное поле длиной 2 байта. Присвойте этому параметру значение 0.

count
Поле размером 4 байта, используемое как счетчик текущего результирующего набора. Если в поле status установлен флаг SRV_DONE_COUNT, поле count содержит допустимое значение счетчика.

Возвраты

SUCCEED или FAIL

Замечания

По запросу клиента сервер может выполнить ряд команд и вернуть несколько результирующих наборов. Для каждого результирующего набора функция srv_senddone должна вернуть клиенту сообщение о завершении с результатом.

Поле count указывает количество строк, затронутых командой. Если в поле count содержится значение счетчика, то в поле status должен быть установлен флаг SRV_DONE_COUNT. Это значение позволяет клиенту провести различие между значением count (равным 0) и неиспользуемым полем count .

Нельзя вызывать функцию srv_senddone из обработчика SRV_CONNECT.