Registry.PerformanceData Feld

Definition

Enthält Leistungsinformationen für Softwarekomponenten. In diesem Feld wird der Windows Registrierungsbasisschlüssel HKEY_PERFORMANCE_DATA gelesen.

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 

Feldwert

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie die Unterschlüssel dieses Schlüssels abrufen und deren Namen auf dem Bildschirm drucken. Verwenden Sie die OpenSubKey Methode, um eine Instanz des jeweiligen Unterschlüssels zu erstellen. Anschließend können Sie andere Vorgänge RegistryKey verwenden, um diesen Schlüssel zu bearbeiten. Beachten Sie, dass in diesem Beispiel häufig keine Ergebnisse zurückgegeben werden können, da möglicherweise keine Leistungsdaten vorhanden sind.

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

Hinweise

Jede Softwarekomponente erstellt Schlüssel für ihre Objekte, Leistungsindikatoren, wenn sie installiert ist, und schreibt Zählerdaten, während sie ausgeführt wird. Sie können auf diese Daten zugreifen, wie Sie auf alle anderen Registrierungsdaten zugreifen würden, indem Sie die RegistryKey Funktionen verwenden.

Obwohl Sie die Registrierung zum Sammeln von Leistungsdaten verwenden, werden die Daten nicht in der Registrierungsdatenbank gespeichert. Stattdessen bewirkt der Zugriff auf die Registrierung mit diesem Schlüssel, dass das System die Daten aus den entsprechenden Systemobjektmanagern sammelt.

Um Leistungsdaten aus dem lokalen System abzurufen, verwenden Sie die GetValue Methode mit dem Schlüssel Registry.PerformanceData. Der erste Aufruf öffnet den Schlüssel (Sie müssen den Schlüssel nicht explizit zuerst öffnen). Achten Sie jedoch darauf, die Close Methode zum Schließen des Handles mit dem Schlüssel zu verwenden, wenn Sie mit dem Abrufen von Leistungsdaten fertig sind. Der Benutzer kann eine Softwarekomponente nicht installieren oder entfernen, während seine Leistungsdaten verwendet werden.

Um Leistungsdaten von einem Remotesystem abzurufen, müssen Sie die OpenRemoteBaseKey Methode mit dem Computernamen des Remotesystems und dem Schlüssel Registry.PerformanceData verwenden. Dieser Aufruf ruft einen Schlüssel ab, der die Leistungsdaten für das Remotesystem darstellt. Rufen Sie GetValue zum Abrufen der Daten diesen Schlüssel anstelle des Schlüssels Registry.PerformanceData auf.

Note

Auf Windows Server 2003 muss ein Benutzer mindestens zur Gruppe Leistungsmonitor Benutzer gehören, um auf Unterschlüssel dieses Basisschlüssels zuzugreifen.

Gilt für: