• 發行項

srv_paramset (擴充預存程序 API)

重要事項重要事項

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

設定遠端預存程序呼叫傳回參數的値。此函數已被 srv_paramsetoutput 函數取代。

語法


int srv_paramset (
SRV_PROC *
srvproc
,
int
n
, 
void *
data
,
int
len 
);

引數

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

  • n
    表示要設定的參數數目。第一個參數是 1。

  • data
    這是指向要當做遠端預存程序傳回參數傳回給用戶端之資料值的指標。

  • len
    指定要傳回之資料的實際長度。如果參數的資料類型具有固定長度，而且不允許 null 值 (例如 srvbit 或 srvint1)，則會忽略 len。

傳回值

如果參數值設定成功則會傳回 SUCCEED，否則會傳回 FAIL。當目前沒有遠端預存程序、沒有第 n 個遠端預存程序參數、此參數不是傳回參數而且 len 引數不合法時，便會傳回 FAIL。

如果 len是 0，它會傳回 NULL。將 len 設定為 0 是將 NULL 傳回給用戶端的唯一方法。

如果參數是 Microsoft SQL Server 2005 資料類型的一種，則此函數會傳回下列値。

新的資料類型

傳回資料長度

BITN

NULL：len = 0、data = IG、RET = 0

ZERO：無

>=255：無

<255：無

BIGVARCHAR

NULL：len = 0、data = IG、RET = 1

ZERO：len = IG、data = IG、RET = 0

>=255：len = max8k、data = valid、RET = 0

<255：len = <8k、data = valid、RET = 1

BIGCHAR

NULL：len = 0、data = IG、RET = 1

ZERO：len = IG、data = IG、RET = 0

>=255：len = max8k、data = valid、RET = 0

<255：len = <8k、data = valid、RET = 1

BIGBINARY

NULL：len = 0、data = IG、RET = 1

ZERO：len = IG、data = IG、RET = 0

>=255：len = max8k、data = valid、RET = 0

<255：len = <8k、data = valid、RET = 1

BIGVARBINARY

NULL：len = 0、data = IG、RET = 1

ZERO：len = IG、data = IG、RET = 0

>=255：len = max8k、data = valid、RET = 0

<255：len = <8k、data = valid、RET = 1

NCHAR

NULL：len = 0、data = IG、RET = 1

ZERO：len = IG、data = IG、RET = 0

>=255：len = max8k、data = valid、RET = 0

<255：len = <8k、data = valid、RET = 1

NVARCHAR

NULL：len = 0、data = IG、RET = 1

ZERO：len = IG、data = IG、RET = 0

>=255：len = max8k、data = valid、RET = 0

<255：len = <8k、data = valid、RET = 1

NTEXT

NULL：len = IG、data = IG、RET = 0

ZERO：len = IG、data = IG、RET = 0

>=255：len = IG、data = IG、RET = 0

<255：len = IG、data = IG、RET = 0

RET = srv_paramset 的傳回值

 

IG = 值將會被略過

 

valid = 資料的任何有效指標

 

備註

參數包含了在用戶端和應用程式之間傳遞的資料，其中包含遠端預存程序。用戶端可以將某些參數指定為傳回參數。這些傳回參數可包含「開放式資料服務」伺服器應用程式傳回給用戶端的值。使用傳回參數類似於依參考方式傳遞參數。

您不能針對未當做傳回參數叫用的參數來設定傳回值。您可以使用 srv_paramstatus 來決定要如何叫用此參數。

這個函數會設定參數的傳回值，但是實際上並不會將傳回值傳給用戶端。當呼叫 srv_senddone 並有設定狀態旗標 SRV_DONE_FINAL 時，所有傳回參數 (不論是否已經使用 srv_paramset 來設定其傳回值) 都會自動傳給用戶端。

當遠端預存程序呼叫是利用參數來進行時，這些參數可以依名稱或位置 (未命名) 傳遞。如果遠端預存程序呼叫是藉由一些依名稱傳遞的參數和一些依位置傳遞的參數來進行時，就會發生錯誤。雖然仍會呼叫 SRV_RPC 處理常式，但是看起來好像沒有參數，而且 srv_rpcparams 會傳回 0。

安全性注意事項安全性注意事項

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