Поделиться через

  • Статья

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

Важное примечаниеВажно!

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

Указывает текущую длину данных в байтах столбца переменной длины или столбца, допускающего значения NULL.

Синтаксис

        int srv_setcollen (
        SRV_PROC *
        srvproc
        ,
        int 
        column
        ,
        int
        len 
        );

Аргументы

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

  • column
    Указывает номер столбца, для которого задана длина данных. Нумерация столбцов начинается с 1.

  • len
    Указывает длину столбца данных в байтах. Длина 0 означает, что значение данных столбца NULL.

Возвращаемое значение

SUCCEED или FAIL.

Замечания

Каждый столбец строки должен сначала быть определен с помощью srv_describe. Длина данных столбца устанавливается последним вызовом к srv_describe или srv_setcollen. Если в строке изменяются данные переменной длины (завершающиеся нулевым символом), необходимо использовать srv_setcollen, чтобы установить новую длину перед вызовом srv_sendrow. Для столбца, в котором разрешены значения NULL, srv_describe должен быть вызван с параметром desttype, для которого установлен тип данных, допускающий значения NULL (как SRVINTN), а данные, которые могут принимать значение NULL, задаются путем вызова srv_setcollen с параметром len, установленным в значение 0. Данные нулевой длины не могут быть заданы с использованием API-интерфейса расширенных хранимых процедур.

Обратите внимание, что если тип данных столбца имеет переменную длину, len не проверяется. Если эта функция вызвана для столбца переменной длины, то возвращается значение FAIL.

Примечание по безопасностиПримечание по безопасности

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