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

Важно!
В будущей версии Microsoft 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-интерфейс расширенных хранимых процедур)