srv_rpcname (擴充預存程序 API)

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

傳回目前遠端預存程序的程序名稱元件。

語法

DBCHAR * srv_rpcname (
SRV_PROC *
srvproc
,
int *
len 
);

引數

• srvproc
  這是 SRV_PROC 結構的指標，也是特定用戶端連接的控制代碼 (此案例中為接收遠端預存程序的控制代碼)。此結構包含了一些資訊，擴充預存程序 API 程式庫會使用這些資訊來管理應用程式與用戶端之間的通訊和資料。

• len
  這是整數變數的指標，此變數會接收資料庫名稱的長度。如果 len 是 NULL，則不會傳回遠端預存程序名稱的長度。

傳回值

目前遠端預存程序之遠端預存程序名稱元件中以 Null 結尾字串的 DBCHAR 指標。如果目前沒有遠端預存程序，則會傳回 NULL 且 len 設定為 - 1。

備註

此函數只會傳回遠端預存程序的名稱。這不包含擁有者、資料庫名稱和遠端預存程序號碼的選擇性規範。

由於沒有遠端預存程序時呼叫 srv_rpcname 是有效的作法 (不會出現任何參考用錯誤)，所以這個函數會提供一種方法來判斷遠端預存程序是否存在。

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