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

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

Внимание

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

Возвращает сведения о подключении к базе данных.

Синтаксис

  
DBCHAR * srv_pfield (  
SRV_PROC *  
srvproc  
,  
int   
field  
,  
int *  
len  
);  

Аргументы

srvproc
Указатель, определяющий подключение к базе данных.

field
Задает возвращаемые сведения о соединении.

Значение	Возвраты
SRV_APPLNAME	Имя приложения, задаваемое клиентом при установлении соединения.
SRV_BCPFLAG	Флаг, имеющий значение TRUE, если клиент готовится к операции массового копирования, и FALSE в противном случае.
SRV_CLIB	Имя библиотеки, позволяющей клиенту общаться с сервером.
SRV_CPID	Идентификатор клиентского процесса на клиентском компьютере-источнике.
SRV_HOST	Имя клиентского компьютера, сообщаемое клиентом при установлении соединения.
SRV_LIBVERS	Версия клиентской библиотеки.
SRV_LSECURE	Флаг. Имеет значение TRUE, если соединение использует для входа в систему встроенную безопасность Windows.
SRV_NETWORK_MODULE	Имя сетевой библиотеки DLL, используемой соединением.
SRV_NETWORK_VERSION	Версия сетевой библиотеки DLL, используемой соединением.
SRV_NETWORK_CONNECTION	Строка соединения, передаваемая в сетевую библиотеку DLL и используемая для текущего соединения srvproc.
SRV_PIPEHANDLE	Строка, содержащая дескриптор канала подключенного клиента, или NULL, если клиент подключен по сети, не использующей именованные каналы. Чтобы использовать этот дескриптор в качестве допустимого дескриптора канала с Microsoft Windows, преобразуйте эту строку в целое число.
SRV_RMTSERVER	Сервер, с которого вошел в систему клиентский процесс. Если вход в систему выполнялся с клиента, значение представляет собой пустую строку.
SRV_ROWSENT	Количество строк, уже переданных процессом srvproc для текущего набора результатов.
SRV_SPID	Идентификатор серверного потока srvproc. Для расширенных хранимых процедур это значение совпадает со столбцом kpid таблицы sys.sysprocesses и может изменяться со временем.
SRV_SPROC_CODEPAGE	Кодовая страница, используемая сервером для интерпретации данных в многобайтовой кодировке.
SRV_STATUS	Текущее состояние srvproc: запущена или закрыта
SRV_TYPE	Тип соединения srvproc. Если сервер возвращается, srvproc находится из экземпляра SQL Server. Если возвращается значение client, srvproc принадлежит клиенту DB-Library или ODBC.
SRV_USER	Имя пользователя, которое использовалось для установки соединения.

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

Возвраты

Указатель на оканчивающуюся нулевым байтом строку, содержащую текущее значение указанного поля в процедуре SRV_PROC. Если поле пусто, то возвращается допустимый указатель на пустую строку, а len содержит 0. Если поле неизвестно, то возвращается значение NULL, а len содержит значение –1.

Внимание

Необходимо тщательно просмотреть исходный код расширенных хранимых процедур и проверить скомпилированные библиотеки DLL перед их установкой на рабочий сервер. Дополнительные сведения об исследовании и проверке безопасности см. в Центре разработчиков безопасности.