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

Статья
08/21/2023

Область применения: SQL Server

Внимание

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

Возвращает сведения о параметре. Эта функция заменяет следующие: srv_paramtype, srv_paramlen, srv_parammaxlen и srv_paramdata. srv_paraminfo поддерживает типы данных, указанные в разделе Типы данных, и данные нулевой длины.

Синтаксис

  
int srv_paraminfo (  
SRV_PROC *  
srvproc  
,  
int  
n  
,  
BYTE *  
pbType  
,  
ULONG *  
pcbMaxLen  
,  
ULONG *  
pcbActualLen  
,  
BYTE *  
pbData  
,  
BOOL *  
pfNull  
);

Аргументы

srvproc
Дескриптор для клиентского соединения.

n
Порядковый номер устанавливаемого столбца. Первый параметр имеет значение 1.

pbType
Тип данных параметра.

pcbMaxLen
Указатель на максимальную длину параметра.

pcbActualLen
Указатель на фактическую длину параметра. Значение 0 (*pcbActualLen == 0) обозначает данные нулевой длины, если *pfNull имеет значение FALSE.

pbData
Указатель на буфер данных параметра. Если pbData не равно NULL, API процедуры расширенного хранилища записывает *pcbActualLen байт данных в *pbData. Если pbData имеет значение NULL, данные не записываются в *pbData, но функция возвращает *pbType, *pcbMaxLen, *pcbActualLen и *pfNull. Управление памятью для этого буфера должно осуществляться приложением.

pfNull
Указатель на флаг null *pfNull устанавливается в значение TRUE, если параметр имеет значение NULL.

Возвраты

При успешном получении сведений о параметре возвращается значение SUCCEED; в иных случаях – значение FAIL. Значение FAIL возвращается, если удаленной хранимой процедуры сейчас не существует или у нее нет параметра с номером n.

Замечания

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

См. также

Справочник по программированию расширенных хранимых процедур

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