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

  • Статья

Область применения: 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.

Внимание

Необходимо тщательно просмотреть исходный код расширенных хранимых процедур и проверить скомпилированные библиотеки DLL перед их установкой на рабочий сервер. Сведения о проверке безопасности см. на следующем веб-сайте Майкрософт.