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 перед их установкой на рабочий сервер. Сведения о проверке безопасности см. на следующем веб-сайте Майкрософт.

См. также

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