srv_sendmsg （擴充預存程式 API）

適用於：SQL Server

重要

SQL Server 的未來版本將移除此功能。 請避免在新的開發工作中使用這項功能，並規劃修改目前使用這項功能的應用程式。 請改用 CLR 整合。

將訊息傳送至用戶端。

語法

  
int srv_sendmsg (  
SRV_PROC *  
srvproc  
,  
int  
msgtype  
,  
DBINT  
msgnum  
,  
DBTINYINT  
class  
,   
DBTINYINT  
state  
,  
DBCHAR *  
rpcname  
,  
int   
rpcnamelen  
,  
DBUSMALLINT  
linenum  
,  
DBCHAR *  
message  
,  
int  
msglen   
);  

引數

srvproc
這是特定用戶端連接句柄之SRV_PROC結構的指標（在此案例中為接收語言要求的句柄）。 結構包含擴充預存程式 API 連結庫用來管理應用程式和客戶端之間的通訊和資料的資訊。

msgtype
視伺服器傳送資訊或錯誤訊息而定，SRV_MSG_INFO或SRV_MSG_ERROR。

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

class
指定錯誤嚴重性。 小於或等於10的嚴重性被視為參考訊息。

state
提供目前訊息的錯誤狀態號碼。 錯誤狀態號碼會提供錯誤內容的相關信息。 有效的狀態號碼是從 0 到 255。

rpcname
目前不支援。

rpcnamelen
目前不支援。

布魯姆
這是套用訊息之語言命令批次中的行號。 行號從 1 開始。 如果 布底布 不適用於訊息，請將 設定為 0。

message
這是要傳送至用戶端之字元字串的指標。

msglen
指定訊息的長度，以位元組為單位。 如果訊息為 null 終止，請將 msglen 設定為 SRV_NULLTERM。

傳回

SUCCEED 或FAIL

備註

此函式會將錯誤或參考訊息傳送至用戶端。 它會針對要傳送的每個訊息呼叫一次。

訊息可以在所有數據列之前或之後以任何順序傳送 srv_sendmsg 傳送 srv_sendrow。 所有訊息，如果有的話，都必須傳送至用戶端，才能傳送完成狀態，並搭配 srv_senddone。

若要在 Unicode 中傳送訊息，請使用 srv_wsendmsg ，而不是 srv_sendmsg。

如需詳細資訊，請參閱 Unicode 資料和伺服器代碼頁。

重要

您應該徹底檢閱擴充預存程式的原始程式碼，而且您應該先測試已編譯的 DLL，再於實際執行伺服器上安裝它們。 如需安全性檢閱和測試的相關信息，請參閱此 Microsoft網站。