srv_wsendmsg (API-интерфейс расширенных хранимых процедур)
Область применения: SQL Server
Внимание
Эта функция будет удалена в будущей версии SQL Server. Избегайте использования этого компонента в новых разработках и запланируйте изменение существующих приложений, в которых он применяется. Пользуйтесь вместо этого интеграцией со средой CLR.
Отправляет клиенту сообщение в Юникоде.
Синтаксис
int srv_wsendmsg(SRV_PROC *
srvproc
, int
msgnum
, int
severity
, WCHAR *
message
, int
msglen
);
Аргументы
srvproc
Указатель на структуру SRV_PROC, который представляет собой дескриптор соединения с клиентом. Эта структура содержит сведения, которые используются библиотекой API-интерфейса расширенных хранимых процедур для управления связью и передачи данных между приложением и клиентом.
Msgnum
4-байтовый номер сообщения.
Уровень серьезности
Указывает серьезность ошибки. Серьезность, меньше или равная 10, считается информационным сообщением, в противном случае — ошибкой.
message
Является указателем на строку в Юникоде, которая должна быть отправлена клиенту.
msglen
Указывает длину messageв символах.
Возвраты
SUCCEED или FAIL.
Замечания
Эта функция используется для отправки сообщения в Юникоде. Она сходна с функцией srv_sendmsg, но сообщение, которое она отправляет, является строкой типа WCHAR, а не строкой типа DBCHAR. Следует отметить, что длина сообщения считается в символах, а не в байтах, а также msglen никогда не будет равно SRV_NULLTERM.
Функция возвращает значение FAIL, если:
значение msglen лежит вне диапазона 0-32242;
значение msglen равно 0, но значение указателя сообщения равно NULL;
при отправке сообщения об ошибке через сеть возникает ошибка.
Внимание
Необходимо тщательно просмотреть исходный код расширенных хранимых процедур и проверить скомпилированные библиотеки DLL перед их установкой на рабочий сервер. Сведения о проверке безопасности см. на следующем веб-сайте Майкрософт.