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

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

Вызывает установленный обработчик сообщений API-интерфейса расширенных хранимых процедур. Эта функция обычно используется для вызова Microsoft SQL Server из расширенной хранимой процедуры для регистрации ошибки (определенной расширенной хранимой процедурой) в файле журнала ошибок SQL Server или журнале приложений Microsoft Windows.

Синтаксис

        int srv_message_handler (
        SRV_PROC *
        srvproc
        ,
        int
        errornum
        ,
        BYTE 
        severity
        ,
        BYTE
        state
        ,
        int
        oserrnum
        ,
        char *
        errtext
        ,
        int
        errtextlen
        ,
        char *
        oserrtext
        ,
        int
        oserrtextlen
        );
      

Аргументы

• srvproc
  Указатель на структуру SRV_PROC, который представляет собой дескриптор соединения с клиентом. Параметр srvproc содержит сведения, которые используются для управления связью и передачи данных между приложением и клиентом.

• errornum
  Номер ошибки, определенный расширенной хранимой процедурой. Это значение должно быть от 50 001 до 2 147 483 647.

• severity
  Стандартное значение серьезности SQL Server для ошибки. Это значение должно быть от 0 до 24.

• state
  Значение состояния SQL Server для ошибки.

• oserrnum
  Номер ошибки операционной системы. Этот аргумент не учитывается.

• errtext
  Описание ошибки errornum расширенной хранимой процедуры.

• errtextlen
  Длина строки ошибки errtext расширенной хранимой процедуры.

• oserrtext
  Описание ошибки операционной системы oserrnum. Этот аргумент не учитывается.

• oserrtextlen
  Длина строки ошибки операционной системы oserrtext.

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

SUCCEED или FAIL.

Замечания

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

Если сообщение об ошибке длиннее, оно усекается до 412 байт.

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