srv_wsendmsg (擴充預存程式 API)
適用於:SQL Server
重要
SQL Server 的未來版本將移除此功能。 請避免在新的開發工作中使用這項功能,並規劃修改目前使用這項功能的應用程式。 請改用 CLR 整合。
將 Unicode 訊息傳送至用戶端。
語法
int srv_wsendmsg(SRV_PROC *
srvproc
, int
msgnum
, int
severity
, WCHAR *
message
, int
msglen
);
引數
srvproc
這是特定用戶端連接句柄之SRV_PROC結構的指標。 結構包含擴充預存程式 API 連結庫用來管理應用程式和客戶端之間的通訊和資料的資訊。
Msgnum
這是 4 位元組的訊息編號。
嚴重性
指定錯誤的嚴重性。 小於或等於10的嚴重性被視為參考訊息;否則為錯誤。
message
這是要傳送至用戶端之 Unicode 字串的指標。
msglen
指定訊息的長度,以字元為單位。
傳回
SUCCEED 或FAIL。
備註
使用此函式在 Unicode 中傳送訊息。 它類似於 srv_sendmsg,但它傳送的訊息是 WCHAR 字串,而不是輸入 DBCHAR 字串。 請注意,訊息長度會以字元而非位元組回報,而 msglen 永遠不會等於SRV_NULLTERM。
當函式傳回FAIL時
指定的 msglen 不在 0-32242 的範圍內。
提供的 msglen 為 0,但訊息指標為 NULL。
透過網路傳送錯誤訊息時發生錯誤。
重要
您應該徹底檢閱擴充預存程式的原始程式碼,而且您應該先測試已編譯的 DLL,再於實際執行伺服器上安裝它們。 如需安全性檢閱和測試的相關信息,請參閱此 Microsoft網站。