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

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

См. также

Справочник

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