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網站。

另請參閱

srv_sendmsg （擴充預存程式 API）