srv_pfield （擴充預存程式 API）

適用於：SQL Server

重要

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

傳回資料庫連接的相關信息。

語法

  
DBCHAR * srv_pfield (  
SRV_PROC *  
srvproc  
,  
int   
field  
,  
int *  
len  
);  

引數

srvproc
識別資料庫連接的指標。

field
指定要傳回之連接上的數據。

值	傳回
SRV_APPLNAME	用戶端在建立連線時所提供的應用程式名稱。
SRV_BCPFLAG	如果用戶端正在準備大量複製作業，則為TRUE的旗標;否則為 FALSE。
SRV_CLIB	可讓客戶端與伺服器通訊的連結庫名稱。
SRV_CPID	用戶端來源電腦上的用戶端進程識別碼。
SRV_HOST	用戶端在建立連線時所提供的用戶端計算機名稱。
SRV_LIBVERS	用戶端連結庫的版本。
SRV_LSECURE	旗標。 如果連接使用整合式安全性登入，則為TRUE。
SRV_NETWORK_MODULE	連接所使用的 Net-Library DLL 名稱。
SRV_NETWORK_VERSION	連接所使用的 Net-Library DLL 版本。
SRV_NETWORK_CONNECTION	傳遞至用於目前 srvproc 連線之 Net-Library DLL 的 連接字串。
SRV_PIPEHANDLE	包含已連線用戶端管道句柄的字串，如果用戶端連線在未使用命名管道的網路上，則為 NULL。 若要將此句柄當做 Microsoft Windows 的有效管道句柄，請將此字串轉換成整數。
SRV_RMTSERVER	用戶端進程從中登入的伺服器。 如果登入來自客戶端，這個值就是空字串。
SRV_ROWSENT	srvproc 針對目前的結果集所傳送的數據列數目。
SRV_SPID	srvproc 的伺服器線程標識碼。 對於擴充預存程式，此值與 sys.sysprocesses 的 kpid 數據行相同，而且可能會隨著時間而變更。
SRV_SPROC_CODEPAGE	伺服器用來解譯 multbyte 數據的代碼頁。
SRV_STATUS	srvproc 的目前狀態：執行或關閉
SRV_TYPE	srvproc 的連接類型。 如果傳回伺服器， srvproc 是來自 SQL Server 的實例。 如果傳回用戶端， srvproc 來自 DB-Library 或 ODBC 用戶端。
SRV_USER	連接的用戶名稱。

len
這是 int 變數的指標，其中包含傳回域值的長度。 如果 len 為 NULL，則不會傳回字串的長度。

傳回

null 終止字串的指標，其中包含SRV_PROC結構中指定字段的目前值。 如果欄位是空的，則會傳回空字串的有效指標，而 len 包含 0。 如果字段未知，則會傳回NULL，而 len 包含值 -1。

重要

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