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

Применимо к:SQL Server

Внимание

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

Возвращает указатель на данные, содержащие в запрошенном поле SRV_PROC.

Синтаксис

  
void *srv_pfieldex(SRV_PROC *   
srvproc  
, int   
field  
, int *   
len  
);  

Аргументы

srvproc
Указатель на структуру SRV_PROC, который представляет собой дескриптор соединения с клиентом. Эта структура содержит сведения, которые используются библиотекой API-интерфейса расширенных хранимых процедур для управления связью и передачи данных между приложением и клиентом.

field
Указывает возвращаемое поле srvproc.

Поле	Description	Тип возвращаемых данных
SRV_MSGLCID	Код языка сообщения текущего сеанса.	ULONG*
SRV_INSTANCENAME	Имя экземпляра (для именованного экземпляра), иначе возвращает значение NULL.	WCHAR*

len
Указатель на переменную типа int, которая содержит длину возвращенного значения field в байтах. Если значение len равно NULL, длина не возвращается. Если возвращается значение NULL, то параметру *len задается значение 0.

Возвраты

Указатель на данные, тип которых зависит от field. Если len имеет значение NULL или srvproc имеет значение NULL, возвращается значение NULL. Если field неизвестно, то возвращается значение NULL. Если возвращается значение NULL, то параметру *len задается значение 0.

Внимание

Буфер, возвращенный из сервера, должен быть доступен только для чтения. В противном случае состояние сервера может быть повреждено.

Замечания

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