Registry.PerformanceData フィールド

定義

名前空間:

Microsoft.Win32

アセンブリ:

Microsoft.Win32.Registry.dll

ソフトウェア コンポーネントのパフォーマンス情報が含まれます。 このフィールドには、Windows レジストリの基本キー HKEY_PERFORMANCE_DATA が読み込まれます。

public: static initonly Microsoft::Win32::RegistryKey ^ PerformanceData;

public static readonly Microsoft.Win32.RegistryKey PerformanceData;

 staticval mutable PerformanceData : Microsoft.Win32.RegistryKey

Public Shared ReadOnly PerformanceData As RegistryKey 

フィールド値

RegistryKey

例

次の例では、このキーのサブキーを取得し、その名前を画面に出力する方法を示します。 メソッドを OpenSubKey 使用して、目的の特定のサブキーのインスタンスを作成します。 その後、 で他の RegistryKey 操作を使用して、そのキーを操作できます。 この例では、パフォーマンス データが存在しない可能性があるため、多くの場合、結果が返されない場合があることに注意してください。

using namespace System;
using namespace Microsoft::Win32;
void PrintKeys( RegistryKey ^ rkey )
{
   
   // Retrieve all the subkeys for the specified key.
   array<String^>^names = rkey->GetSubKeyNames();
   int icount = 0;
   Console::WriteLine( "Subkeys of {0}", rkey->Name );
   Console::WriteLine( "-----------------------------------------------" );
   
   // Print the contents of the array to the console.
   System::Collections::IEnumerator^ enum0 = names->GetEnumerator();
   while ( enum0->MoveNext() )
   {
      String^ s = safe_cast<String^>(enum0->Current);
      Console::WriteLine( s );
      
      // The following code puts a limit on the number
      // of keys displayed.  Comment it out to print the
      // complete list.
      icount++;
      if ( icount >= 10 )
            break;
   }
}

int main()
{
   
   // Create a RegistryKey, which will access the HKEY_PERFORMANCE_DATA
   // key in the registry of this machine.
   RegistryKey ^ rk = Registry::PerformanceData;
   
   // Print out the keys.
   PrintKeys( rk );
}

using System;
using Microsoft.Win32;

class Reg {
    public static void Main() {

        // Create a RegistryKey, which will access the HKEY_PERFORMANCE_DATA
        // key in the registry of this machine.
        RegistryKey rk = Registry.PerformanceData;

        // Print out the keys.
        PrintKeys(rk);
    }

    static void PrintKeys(RegistryKey rkey) {

        // Retrieve all the subkeys for the specified key.
        string [] names = rkey.GetSubKeyNames();

        int icount = 0;

        Console.WriteLine("Subkeys of " + rkey.Name);
        Console.WriteLine("-----------------------------------------------");

        // Print the contents of the array to the console.
        foreach (string s in names) {
            Console.WriteLine(s);

            // The following code puts a limit on the number
            // of keys displayed.  Comment it out to print the
            // complete list.
            icount++;
            if (icount >= 10)
                break;
        }
    }
}

Imports Microsoft.Win32

Class Reg
    
    Public Shared Sub Main()
        
        ' Create a RegistryKey, which will access the HKEY_PERFORMANCE_DATA 
        ' key in the registry of this machine.
        Dim rk As RegistryKey = Registry.PerformanceData
        
        ' Print out the keys.
        PrintKeys(rk)
    End Sub    
    
    Shared Sub PrintKeys(rkey As RegistryKey)
        
        ' Retrieve all the subkeys for the specified key.
        Dim names As String() = rkey.GetSubKeyNames()
        
        Dim icount As Integer = 0
        
        Console.WriteLine("Subkeys of " & rkey.Name)
        Console.WriteLine("-----------------------------------------------")
        
        ' Print the contents of the array to the console.
        Dim s As String
        For Each s In  names
            Console.WriteLine(s)
            
            ' The following code puts a limit on the number
            ' of keys displayed.  Comment it out to print the
            ' complete list.
            icount += 1            
            If icount >= 10 Then
                Exit For
            End If
        Next s
    End Sub
End Class

注釈

各ソフトウェア コンポーネントは、オブジェクトのキー、インストール時のカウンターを作成し、実行中にカウンター データを書き込みます。 関数を使用して、他のレジストリ データにアクセスする場合と同様に、このデータに RegistryKey アクセスできます。

レジストリを使用してパフォーマンス データを収集しますが、データはレジストリ データベースに格納されません。 代わりに、このキーを使用してレジストリにアクセスすると、システムは適切なシステム オブジェクト マネージャーからデータを収集します。

ローカル システムからパフォーマンス データを取得するには、 メソッドと GetValue Registry.PerformanceData キーを使用します。 最初の呼び出しでキーが開きます (最初にキーを明示的に開く必要はありません)。 ただし、パフォーマンス データの取得が Close 完了したら、 メソッドを使用してキーのハンドルを閉じてください。 パフォーマンス データが使用されている間、ユーザーはソフトウェア コンポーネントをインストールまたは削除できません。

リモート システムからパフォーマンス データを取得するには、 メソッドを OpenRemoteBaseKey 使用し、リモート システムのコンピューター名と Registry.PerformanceData キーを使用する必要があります。 この呼び出しは、リモート システムのパフォーマンス データを表すキーを取得します。 データを取得するには、Registry.PerformanceData キーではなく、このキーを使用して を呼び出 GetValue します。

注意

Windows Server 2003 では、ユーザーがこの基本キーのサブキーにアクセスするには、少なくとも パフォーマンス モニター Users グループに属している必要があります。