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

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

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

Синтаксис

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

Аргументы

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

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

  Флаг состояния	Описание
  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-библиотеки перед их установкой на рабочий сервер. Сведения о проверке безопасности см. на следующем веб-узле Майкрософт.