NetStatisticsGet 関数 (lmstats.h)

[アーティクル]
03/05/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

このパラメーターは 0 である必要があります。

[out] Buffer

データを受信するバッファーへのポインター。このデータの形式は 、level パラメーターの値によって異なります。このバッファーはシステムによって割り当てられ、 NetApiBufferFree 関数を使用して解放する必要があります。詳細については、「ネットワーク管理機能バッファー」および「ネットワーク管理機能バッファーの長さ」を参照してください。

戻り値

関数が成功した場合、戻り値は NERR_Success。

関数が失敗した場合、戻り値はシステムエラーコードです。エラーコードの一覧については、「システムエラーコード」を参照してください。

注釈

ワークステーション統計を取得するために特別なグループ・メンバーシップは必要ありません。リモートサーバーで NetStatisticsGet 関数を正常に実行できるのは、Administrators または Server Operators ローカルグループのメンバーだけです。

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップアプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
対象プラットフォーム	Windows
ヘッダー	lmstats.h (Lm.h を含む)
Library	Netapi32.lib
[DLL]	Netapi32.dll