srv_pfieldex (擴充預存程序 API)

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

傳回含有要求之 SRV_PROC 欄位的資料的指標。

語法

void *srv_pfieldex(SRV_PROC * 
srvproc
, int 
field
, int * 
len
);

引數

• srvproc
  是 SRV_PROC 結構的指標，也是特定用戶端連接的控制代碼。擴充預存程序 API 程式庫會使用該結構所包含的資訊來管理通訊以及應用程式與用戶端之間的資料。

• field
  指定要傳回的 srvproc 欄位。

  欄位	說明	傳回類型
  SRV_MSGLCID	目前的工作階段訊息 LCID。	ULONG*
  SRV_INSTANCENAME	執行個體名稱 (如果是具名的)；否則，傳回 NULL。	WCHAR*

• len
  是指向 int 變數的指標，該變數含有傳回 field 值 (以位元組為單位) 的長度。如果 len 是 NULL，則不會傳回長度。當傳回 NULL 時，*len 會設定為 0。

傳回值

指標指向的資料，是依據 field 決定其類型。當 len 是 NULL 或 srvproc 是 NULL 時，會傳回 NULL。如果 field 是未知的，則傳回 NULL。當傳回 NULL 時，*len 會設定為 0。

安全性注意事項
從伺服器傳回的緩衝區應該是唯讀的。否則，伺服器狀態可能會損毀。

備註

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