Статья
04/01/2012

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

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

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

Отправляет клиенту сообщение в Юникоде.

Синтаксис

        int srv_wsendmsg(SRV_PROC * 
        srvproc
        , int 
        msgnum
        , int 
        severity
        , WCHAR * 
        message
        , int 
        msglen
        );

Arguments

srvproc
Указатель на структуру SRV_PROC, который представляет собой дескриптор соединения с клиентом. Эта структура содержит сведения, которые используются библиотекой API-интерфейс расширенных хранимых процедур для управления связью и передачи данных между приложением и клиентом.
Msgnum
4-байтовый номер сообщения.
Severity
Указывает серьезность ошибки. Серьезность, меньше или равная 10, считается информационным сообщением, в противном случае - ошибкой.
message
Является указателем на строку в Юникоде, которая должна быть отправлена клиенту.
msglen
Указывает длину message в символах.

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

SUCCEED или FAIL.

Замечания

Эта функция используется для отправки сообщения в Юникоде. Это сходно с функцией srv_sendmsg, сообщение, которое она отправляет, является строкой типа WCHAR, а не строкой типа DBCHAR. Следует отметить, что длина сообщения считается в символах, а не в байтах, а также msglen никогда не будет равно SRV_NULLTERM.

Функция возвращает значение FAIL, если

Значение msglen лежит вне диапазона 0-32242.
Значение msglen равно 0, но значение указателя сообщения равно NULL.
При отправке сообщения об ошибке через сеть возникает ошибка.

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

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

См. также

Справочник

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

Поделиться через