srv_paramname (API-интерфейс расширенных хранимых процедур)
Область применения: SQL Server
Внимание
Эта функция будет удалена в будущей версии SQL Server. Избегайте использования этого компонента в новых разработках и запланируйте изменение существующих приложений, в которых он применяется. Пользуйтесь вместо этого интеграцией со средой CLR.
Возвращает имя параметра вызова удаленной хранимой процедуры.
Синтаксис
DBCHAR * srv_paramname (
SRV_PROC * srvproc,intn, int *len );
Аргументы
srvproc
Указатель на структуру SRV_PROC, представляющую собой дескриптор соединения с клиентом (в данном случае — дескриптор, который получил вызов удаленной хранимой процедуры). Эта структура содержит сведения, которые используются библиотекой API-интерфейса расширенных хранимых процедур для управления связью и передачи данных между приложением и клиентом.
n
Указывает номер параметра. Первый параметр имеет значение 1.
len
Содержит указатель на переменную int, которая содержит длину имени параметра в байтах. Если параметр len равен NULL, то длина имени параметра удаленной хранимой процедуры не возвращается.
Возвраты
Указатель на строку, заканчивающуюся нулевым символом, которая содержит имя параметра. Длина имени параметра хранится в len. Если параметра с номером n или удаленной хранимой процедуры не существует, то возвращается значение NULL, len получает значение -1 и отправляется информационное сообщение об ошибке. Если имя параметра равно NULL, для len устанавливается значение 0 и возвращается пустая строка, заканчивающаяся нулевым символом.
Замечания
Эта функция возвращает имя параметра вызова удаленной хранимой процедуры. Когда удаленная хранимая процедура вызывается с параметрами, эти параметры могут быть переданы либо по имени, либо по позиции — без указания имени. Если при вызове удаленной хранимой процедуры часть параметров передается по имени, а часть — по позиции, возникает ошибка. Обработчик SRV_RPC по-прежнему вызывается, однако он отображается так, как если бы не имел параметров, а функция srv_rpcparams возвращает 0.
Внимание
Необходимо тщательно просмотреть исходный код расширенных хранимых процедур и проверить скомпилированные библиотеки DLL перед их установкой на рабочий сервер. Сведения о проверке безопасности см. на следующем веб-сайте Майкрософт.