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

См. также

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