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 перед их установкой на рабочий сервер. Дополнительные сведения об исследовании и проверке безопасности см. в Центре разработчиков безопасности.