次の方法で共有

Counters.Add メソッド

  • [アーティクル]

CounterItem インスタンスをコレクションに追加します。

構文

Counters.Add( _
  ByVal pathname As String _
) As CounterItem

パラメーター

pathname [in]

カウンターへのパス。 パスにはマシン名を含めることができます。指定したパフォーマンス オブジェクトが複数のインスタンスをサポートしている場合は、パフォーマンス オブジェクト名、オブジェクト インスタンス名、およびカウンター名を含める必要があります。 このパスの指定では、大文字と小文字は区別されません。

カウンター パスの指定の詳細については、「カウンター パス の指定」を参照してください。

例外

例外の種類 条件
System.Runtime.InteropServices.COMException この例外は、次のいずれかの理由で受け取ることができます。
  • 指定されたパフォーマンス オブジェクトがコンピューターに見つかりませんでした。 Err.Number 値は0xC0000BB8。
  • 指定されたカウンターが見つかりませんでした。 Err.Number 値が0xC0000BB9。

解説

pathname パラメーターにワイルドカード カウンターを指定した場合、Add メソッドは展開されたパスごとに 1 つの CounterItem オブジェクトを作成します。 Add メソッドは 、最初に追加された CounterItem へのポインターを返します。

ワイルドカードによってカウンターが重複する場合、エラーは報告されず、重複は作成されません。 すべてのカウンターが作成される前にエラー状態が発生した場合、エラーが報告され、残りのカウンターは作成されません。

追加できるカウンターの数に制限はありません。ただし、SYSMON はコレクション内の最初の 1,024 カウンターのみをグラフ化します。 SYSMON がレポートに表示するカウンターの数に制限はありません。

カウンターが追加されたときに通知を受信するには、 OnCounterAdded イベントを実装します。

必要条件

要件 値
サポートされている最小のクライアント
 Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows 2000 Server [デスクトップ アプリのみ]
[DLL]
Sysmon.ocx

関連項目

CounterItem

Counters

SystemMonitor.BrowseCounters