NetStatisticsGet 函式 (lmstats.h)

發行項
02/28/2024

擷取服務的作業統計數據。目前僅支援工作站和伺服器服務。

語法

NET_API_STATUS NET_API_FUNCTION NetStatisticsGet(
  [in]  LPTSTR ServerName,
  [in]  LPTSTR Service,
  [in]  DWORD  Level,
  [in]  DWORD  Options,
  [out] LPBYTE *Buffer
);

參數

[in] ServerName

字串的指標，指定函式執行所在伺服器的 DNS 或 NetBIOS 名稱。如果此參數為 NULL，則會使用本機電腦。

[in] Service

字串的指標，指定要取得統計數據之服務的名稱。目前只允許 SERVICE_SERVER 和 SERVICE_WORKSTATION 的值。

[in] Level

指定資料的資訊層級。此參數可以是下列值。

值	意義
0	傳回工作站或伺服器的相關統計數據。 bufptr 參數指向STAT_WORKSTATION_0或STAT_SERVER_0結構。

[in] Options

此參數必須是零。

[out] Buffer

接收數據的緩衝區指標。此數據的格式取決於 level 參數的值。此緩衝區是由系統所配置，必須使用 NetApiBufferFree 函式釋放。如需詳細資訊，請參閱網路管理功能緩衝區和網路管理函式緩衝區長度。

傳回值

如果函式成功，傳回值會 NERR_Success。

如果函式失敗，則傳回值是系統錯誤碼。如需錯誤碼的清單，請參閱系統錯誤碼。

備註

不需要特殊群組成員資格才能取得工作站統計數據。只有 Administrators 或 Server Operators 本地組的成員可以在遠端伺服器上成功執行 NetStatisticsGet 函式。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
目標平台	Windows
標頭	lmstats.h (包含 Lm.h)
程式庫	Netapi32.lib
Dll	Netapi32.dll