srv_paraminfo (擴充預存程序 API)

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

傳回有關參數的資訊。這個函數會取代以下函數：srv_paramtype、srv_paramlen、srv_parammaxlen 和 srv_paramdata。srv_paraminfo 支援＜資料類型＞中的資料類型和零長度的資料。

語法

int srv_paraminfo (
SRV_PROC *
srvproc
,
int
n
,
BYTE *
pbType
,
ULONG *
pcbMaxLen
,
ULONG *
pcbActualLen
,
BYTE *
pbData
,
BOOL *
pfNull
);

引數

• srvproc
  用戶端連接的控制代碼。

• n
  要設定之參數的序數。第一個參數是 1。

• pbType
  參數的資料類型。

• pcbMaxLen
  參數之最大長度的指標。

• pcbActualLen
  參數之實際長度的指標。0 (*pcbActualLen == 0) 的值表示長度為零的資料 (如果 *pfNull 設定為 FALSE)。

• pbData
  參數資料之緩衝區的指標。如果 pbData 不是 NULL，擴充預存程序 API 會將 *pcbActualLen 位元組的資料寫入 *pbData。如果 pbData 是 NULL，不會有任何資料寫入 *pbData，但是此函數會傳回 *pbType、*pcbMaxLen、*pcbActualLen 和 *pfNull。此緩衝區的記憶體必須由應用程式管理。

• pfNull
  null 旗標的指標。如果參數值為 NULL，*pfNull 會設定為 TRUE。

傳回值

如果成功取得參數資訊，則會傳回 SUCCEED，否則會傳回 FAIL。當目前沒有遠端預存程序，而且沒有第 n 個遠端預存程序參數時，就會傳回 FAIL。

備註

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

請參閱

參考

擴充預存程序程式設計人員參考