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

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

Возвращает сведения о соединении с базой данных.

Синтаксис

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

Arguments

• 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. Если возвращается значение server, srvproc принадлежит экземпляру SQL Server. Если возвращается значение client, srvproc принадлежит клиенту DB-Library или ODBC.
  SRV_USER	Имя пользователя, которое использовалось для установки соединения.

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

Возвращаемое значение

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

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