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

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

Внимание

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

Указывает текущий адрес для данных столбца.

Синтаксис

  
int srv_setcoldata (  
SRV_PROC *  
srvproc  
,  
int   
column  
,  
void *  
data   
);  

Аргументы

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

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

data
Указатель для данных столбца. Память, выделенная для data , не должна освобождаться до замены данных столбца с помощью еще одного вызова метода srv_setcoldataили srv_senddone .

Возвраты

SUCCEED или FAIL.

Замечания

Каждый столбец строки должен быть сначала определен с помощью метода srv_describe. Адреса данных столбцов первоначально задаются с помощью метода srv_describe. При изменении адреса данных столбца необходимо вызвать метод srv_setcoldata , чтобы указать новый адрес данных. Метод srv_setcoldata необходимо вызывать для каждого измененного столбца в отдельности.

Данные, содержащие значения NULL, представляются путем задания длины столбца в 0 с помощью метода srv_setcollen. В этом случае адрес данных будет пропущен.

Внимание

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

См. также

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