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，再於實際執行伺服器上安裝它們。 如需安全性檢閱和測試的相關信息，請參閱 資訊安全開發人員中心。