srv_wsendmsg (擴充預存程序 API)

重要事項
未來的 Microsoft SQL Server 版本將移除這項功能。請勿在新的開發工作中使用此功能，並且儘速修改使用此功能的應用程式。 請改用 CLR 整合。

將 Unicode 訊息傳送給用戶端。

語法

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

引數

• srvproc
  這是指向 SRV_PROC 結構的指標，也是特定用戶端連接的控制代碼。擴充預存程序 API 程式庫會使用該結構所包含的資訊來管理應用程式與用戶端之間的通訊和資料。

• Msgnum
  這是 4 位元組的訊息編號。

• Severity
  指定錯誤的嚴重性。嚴重性小於或等於 10 視為參考用訊息，否則就是錯誤。

• message
  這是要傳送給用戶端之 Unicode 字串的指標。

• msglen
  指定 message 的長度 (以字元為單位)。

傳回值

SUCCEED 或 FAIL。

備註

使用這個函數來以 Unicode 傳送訊息。這類似於 srv_sendmsg，但是它所傳送的訊息是 WCHAR 字串，而不是 DBCHAR 類型的字串。請注意，訊息長度是以字元報告，而不是以位元組報告，而且 msglen 絕對不會等於 SRV_NULLTERM。

此函數在下列情況下會傳回 FAIL

• 提供的 msglen 不在 0-32242 範圍中。

• 提供的 msglen 為 0，但是訊息指標為 NULL。

• 當透過網路傳送錯誤訊息時發生錯誤。

安全性注意事項
您應該徹底檢閱擴充預存程序的原始程式碼，您也應該先測試編譯過的 DLL，才能將它們安裝在實際執行伺服器上。如需有關安全性檢閱和測試的資訊，請參閱此 Microsoft 網站 (英文)。

請參閱

參考

srv_sendmsg (擴充預存程序 API)