PDH_COUNTER_INFO_A 構造体 (pdh.h)

PDH_COUNTER_INFO構造体には、カウンターのプロパティを説明する情報が含まれています。 この情報には、カウンター パスも含まれます。

構文

typedef struct _PDH_COUNTER_INFO_A {
  DWORD     dwLength;
  DWORD     dwType;
  DWORD     CVersion;
  DWORD     CStatus;
  LONG      lScale;
  LONG      lDefaultScale;
  DWORD_PTR dwUserData;
  DWORD_PTR dwQueryUserData;
  LPSTR     szFullPath;
  union {
    PDH_DATA_ITEM_PATH_ELEMENTS_A DataItemPath;
    PDH_COUNTER_PATH_ELEMENTS_A   CounterPath;
    struct {
      LPSTR szMachineName;
      LPSTR szObjectName;
      LPSTR szInstanceName;
      LPSTR szParentInstance;
      DWORD dwInstanceIndex;
      LPSTR szCounterName;
    };
  };
  LPSTR     szExplainText;
  DWORD     DataBuffer[1];
} PDH_COUNTER_INFO_A, *PPDH_COUNTER_INFO_A;

メンバー

dwLength

追加された文字列を含む構造体のサイズ (バイト単位)。

dwType

カウンターの種類。 カウンターの種類の一覧については、 Windows Server 2003 展開キットのカウンターの種類に関するセクションを参照してください。 カウンター型の定数は Winperf.h で定義されています。

CVersion

カウンター のバージョン情報。 使用されていません。

CStatus

カウンター値が有効かどうかを示すカウンターの状態。 使用可能な値の一覧については、「 PDH インターフェイスの戻り値の確認」を参照してください。

lScale

カウンターの表示可能な値を計算するときに使用する倍率。 倍率は 10 の累乗です。 このパラメーターの有効な範囲は PDH_MIN_SCALE (–7) です (戻り値は実際の値の時間 10 ⁷) からPDH_MAX_SCALE (+7) です (戻り値は実際の値の時間 10⁺⁷)。 値 0 を指定すると、スケールが 1 に設定され、実際の値が返されます

lDefaultScale

カウンターのプロバイダーが提案する既定のスケール ファクター。

dwUserData

PdhAddCounter を呼び出すときに dwUserData パラメーターで渡される値。

dwQueryUserData

PdhOpenQuery を呼び出すときに dwUserData パラメーターで渡される値。

szFullPath

完全なカウンター パスを指定する Null で終わる文字列。 文字列は、メモリ内のこの構造体に従います。

DataItemPath

PDH_DATA_ITEM_PATH_ELEMENTS構造体。 使用されていません。

CounterPath

PDH_COUNTER_PATH_ELEMENTS構造体。

szMachineName

カウンター パスで指定されたコンピューターの名前を含む Null で終わる文字列。 パスでコンピューターが指定されていない場合は NULL です。 文字列は、メモリ内のこの構造体に従います。

szObjectName

カウンター パスで指定されたパフォーマンス オブジェクトの名前を含む Null で終わる文字列。 文字列は、メモリ内のこの構造体に従います。

szInstanceName

カウンター パスで指定されたオブジェクト インスタンスの名前を含む Null で終わる文字列。 パスでインスタンスが指定されていない場合は NULL です。 文字列は、メモリ内のこの構造体に従います。

szParentInstance

カウンター パスで指定された親インスタンスの名前を含む Null で終わる文字列。 パスで親インスタンスが指定されていない場合は NULL です。 文字列は、メモリ内のこの構造体に従います。

dwInstanceIndex

カウンター パスで指定されたインスタンス インデックス。 パスでインスタンス インデックスが指定されていない場合は 0 です。

szCounterName

カウンター名を含む Null で終わる文字列。 文字列は、メモリ内のこの構造体に従います。

szExplainText

カウンターを説明するヘルプ テキスト。 ソースがログ ファイルの場合は NULL です

DataBuffer[1]

構造体に追加される文字列データの先頭。

注釈

この構造体にメモリを割り当てるときは、この構造体の末尾に追加されるメンバー文字列 ( szCounterName など) に十分なメモリを割り当てます。

要件

要件
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
Header pdh.h

こちらもご覧ください

PDH_COUNTER_PATH_ELEMENTS

PDH_DATA_ITEM_PATH_ELEMENTS

PdhGetCounterInfo