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

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

Внимание

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

См. также

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