次の方法で共有

PDH_BROWSE_DLG_CONFIG_HA構造体 (pdh.h)

  • [アーティクル]

PDH_BROWSE_DLG_CONFIG_H 構造体は、PdhBrowseCountersH 関数によって、の [パフォーマンス カウンターの参照] ダイアログ ボックスを構成するために使用されます。

構文

typedef struct _BrowseDlgConfig_HA {
  DWORD               bIncludeInstanceIndex : 1;
  DWORD               bSingleCounterPerAdd : 1;
  DWORD               bSingleCounterPerDialog : 1;
  DWORD               bLocalCountersOnly : 1;
  DWORD               bWildCardInstances : 1;
  DWORD               bHideDetailBox : 1;
  DWORD               bInitializePath : 1;
  DWORD               bDisableMachineSelection : 1;
  DWORD               bIncludeCostlyObjects : 1;
  DWORD               bShowObjectBrowser : 1;
  DWORD               bReserved : 22;
  HWND                hWndOwner;
  PDH_HLOG            hDataSource;
  LPSTR               szReturnPathBuffer;
  DWORD               cchReturnPathLength;
  CounterPathCallBack pCallBack;
  DWORD_PTR           dwCallBackArg;
  PDH_STATUS          CallBackStatus;
  DWORD               dwDefaultDetailLevel;
  LPSTR               szDialogBoxCaption;
} PDH_BROWSE_DLG_CONFIG_HA, *PPDH_BROWSE_DLG_CONFIG_HA;

メンバーズ

bIncludeInstanceIndex

このフラグが TRUE場合、ダイアログ ボックスには重複するインスタンス名のインデックス番号が含まれます。 たとえば、cmd インスタンスが 2 つある場合、インスタンス リストには cmd と cmd#1 が含まれます。 このフラグが FALSE場合、重複するインスタンス名にインデックス番号は含まれません。

bSingleCounterPerAdd

このフラグが TRUE場合、ダイアログはカウンターを 1 つだけ返します。 このフラグが FALSE場合、ダイアログは複数の選択を返すことができます。ワイルドカードの選択が許可されます。 選択したカウンターは、MULTI_SZ文字列として返されます。

bSingleCounterPerDialog

このフラグが TRUE場合、ダイアログ ボックスは [OK] ボタンと [キャンセル] ボタンを使用します。 ユーザーがいずれかのボタンをクリックすると、ダイアログが返されます。 このフラグが FALSE場合、ダイアログ ボックスは [追加] ボタンと [閉じる] ボタンを使用します。 ユーザーが [閉じる] ボタンをクリックすると、ダイアログ ボックスが閉じます。 [追加] ボタンは複数回クリックできます。 [追加] ボタンをクリックすると、以前に選択した項目が現在選択されている項目で上書きされます。

bLocalCountersOnly

このフラグが TRUE場合、ダイアログ ボックスでは、ローカル コンピューターからのみカウンターを選択できます (パスにはコンピューター名は含まれません)。 このフラグが FALSE場合、ユーザーはカウンターを選択するコンピューターを指定できます。 ユーザーが [ローカル コンピューター カウンター使用] を選択しない限り、コンピューター名の前にカウンター パス 付けられます。

bWildCardInstances

このフラグが TRUE 、ユーザーが [すべてのインスタンス選択した場合、カウンター パスにはインスタンス フィールドのワイルドカード文字が含まれます。

このフラグが FALSEされ、ユーザーが [すべてのインスタンス]選択すると、そのオブジェクトに対して現在見つかったすべてのインスタンスがMULTI_SZ文字列で返されます。

bHideDetailBox

このフラグが TRUE場合、ダイアログ ボックス 表示されるカウンターの詳細レベルを変更できないように、ダイアログ ボックスから詳細レベルの が削除されます。 詳細レベルは、dwDefaultDetailLevel メンバーの値に固定されます。

このフラグが FALSE場合、ダイアログ ボックスに詳細レベル 表示され、表示されるカウンターの詳細レベルをユーザーが変更できるようになります。

表示されるカウンターは、詳細レベルが現在の詳細レベルの選択以下のカウンターであることに注意してください。 ウィザードの詳細レベルを選択すると、すべてのカウンターとオブジェクトが表示されます。

bInitializePath

このフラグが TRUE場合、ダイアログ ボックスが最初に表示されるときに、szReturnPathBuffer で指定されたカウンターとオブジェクトが、コンピューターで指定された既定のカウンターとオブジェクトを使用する代わりに強調表示されます。

このフラグが FALSE場合、コンピューターから返される既定のカウンターとオブジェクト情報を使用して、初期カウンターとオブジェクトが選択されます。

bDisableMachineSelection

このフラグが TRUE場合、ユーザーはコンピューターからカウンターを選択 コンピューターを選択できません。

このフラグが FALSE場合、ユーザーはコンピューターからカウンターを選択 コンピューターを選択できます。 これが既定値です。 PdhConnectMachine を呼び出して他のコンピューターに最初に接続しない限り、一覧にはローカル コンピューターのみが含まれます。

bIncludeCostlyObjects

このフラグが TRUE場合、カウンター リストにはコストの高いデータ (つまり、比較的大量のプロセッサ時間または収集するメモリ オーバーヘッドを必要とするデータ) も含まれます。

このフラグが FALSE場合、一覧にはコストのかかるカウンターは含まれません。 これが既定値です。

bShowObjectBrowser

このフラグが TRUE場合、ダイアログにはパフォーマンス オブジェクトのみが一覧表示されます。 ユーザーがオブジェクトを選択すると、オブジェクトが複数のインスタンス オブジェクトの場合は、インスタンス名とカウンターのオブジェクトとワイルドカード文字を含むカウンター パスが返されます。 たとえば、"Process" オブジェクトが選択されている場合、ダイアログは文字列 "\Process(*)*" を返します。 オブジェクトが単一インスタンス オブジェクトの場合、パスにはカウンターのみのワイルドカード文字が含まれます。 たとえば、"\System*" などです。 その後、PdhExpandWildCardPath パスを渡して、オブジェクトの実際のパスの一覧を取得できます。

bReserved

hWndOwner

ダイアログを所有するウィンドウのハンドル。 NULL場合、所有者はデスクトップです。

hDataSource

PdhBindInputDataSource 関数によって返されるデータ ソースへのハンドル。

szReturnPathBuffer

選択したカウンター パスを含むMULTI_SZへのポインター。

bInitializePath が TRUE場合は、このメンバーを使用して、ダイアログが最初に表示されるときにコンピューター、オブジェクト、カウンター、およびインスタンスリストのエントリを強調表示するためにコンポーネントを使用するカウンター パスを指定できます。

cchReturnPathLength

TCHARでの、szReturnPathBuffer バッファーのサイズ。 コールバック関数が新しいバッファーを再割り当てする場合は、この値も更新する必要があります。

pCallBack

ユーザーの選択を処理するコールバック関数へのポインター。 詳細については、「CounterPathCallBackを する」を参照してください。

dwCallBackArg

コールバック関数に渡される呼び出し元定義の値。

CallBackStatus

コールバック関数へのエントリでは、このメンバーにはパス バッファーの状態が含まれます。 終了時に、コールバック関数は処理の結果として得られる状態値を設定します。

バッファーが小さすぎて現在の選択範囲を読み込めない場合、ダイアログではこの値がPDH_MORE_DATAに設定されます。 この値がERROR_SUCCESSの場合、szReturnPathBuffer メンバーには、有効なカウンター パスまたはカウンター パス リストが含まれます。

コールバック関数が新しいバッファーを再割り当てする場合は、このメンバーを PDH_RETRY に設定して、ダイアログが選択したパスでバッファーを読み込み、コールバック関数をもう一度呼び出そうとします。

他のエラーが発生した場合、コールバック関数は適切な PDH エラー状態値を返す必要があります。

dwDefaultDetailLevel

bHideDetailBox が FALSE場合、詳細レベル リストに表示される既定の詳細レベル。 bHideDetailBox が TRUE場合、ダイアログはこの値を使用して、表示されるパフォーマンス カウンターとオブジェクトをフィルター処理します。 次のいずれかの値を指定できます。

詳細レベル 意味
PERF_DETAIL_NOVICE
 初心者ユーザーはカウンター データを理解できます。
PERF_DETAIL_ADVANCED
 カウンター データは上級ユーザー向けに提供されます。
PERF_DETAIL_EXPERT
 カウンター データは、エキスパート ユーザー向けに提供されます。
PERF_DETAIL_WIZARD
 カウンター データは、システム デザイナー向けに提供されます。

szDialogBoxCaption

ダイアログ ボックスのキャプション バーに表示するオプションのキャプションを指定する、null終了文字列へのポインター。 このメンバーが NULL場合、キャプションは [パフォーマンス カウンターの参照]されます。

備考

[ の追加] ボタンがクリックされるたびに、szReturnPathBuffer バッファーに選択したカウンターが含まれており、pCallBack コールバック関数が呼び出されます。 コールバック関数は、バッファー内の各カウンターに対して PdhAddCounter 関数を呼び出す必要があります。

手記

pdh.h ヘッダーは、unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとしてPDH_BROWSE_DLG_CONFIG_Hを定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows XP [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2003 [デスクトップ アプリのみ]
ヘッダー pdh.h

関連項目

CounterPathCallBack

PdhAddCounter を する

PdhBindInputDataSource の

PdhBrowseCountersH