Registry.DynData Field

Definition

Warning

This API is now obsolete.

Contient les données dynamiques du Registre.Contains dynamic registry data. Ce champ lit la clé de base HKEY_DYN_DATA du Registre Windows.This field reads the Windows registry base key HKEY_DYN_DATA.

public: static initonly Microsoft::Win32::RegistryKey ^ DynData;
public static readonly Microsoft.Win32.RegistryKey DynData;
[System.Obsolete("The DynData registry key only works on Win9x, which is no longer supported by the CLR.  On NT-based operating systems, use the PerformanceData registry key instead.")]
public static readonly Microsoft.Win32.RegistryKey DynData;
[System.Obsolete("Use PerformanceData instead")]
public static readonly Microsoft.Win32.RegistryKey DynData;
 staticval mutable DynData : Microsoft.Win32.RegistryKey
Public Shared ReadOnly DynData As RegistryKey 

Field Value

RegistryKey
Attributes

Exceptions

Le système d'exploitation ne prend pas en charge les données dynamiques ; autrement dit, il ne s'agit pas de Windows 98, Windows 98 Deuxième Édition ou Windows Millennium (Windows Me).The operating system does not support dynamic data; that is, it is not Windows 98, Windows 98 Second Edition, or Windows Millennium Edition (Windows Me).

Examples

L’exemple suivant montre comment récupérer les sous-clés de cette clé et imprime leurs noms à l’écran.The following example demonstrates how to retrieve the subkeys of this key, and prints their names to the screen. Utilisez la méthode OpenSubKey pour créer une instance de la sous-clé particulière qui vous intéresse.Use the OpenSubKey method to create an instance of the particular subkey of interest. Vous pouvez ensuite utiliser d’autres opérations dans RegistryKey pour manipuler cette clé.You can then use other operations in RegistryKey to manipulate that key. Notez que cet exemple ne peut retourner aucun résultat, car il est possible qu’il n’y ait pas de données dynamiques disponibles, ou que vous n’exécutiez pas Windows 98/ME.Note that this example can return no results, since there might not be dynamic data available, or you might not be running Windows 98/ME. L’utilisation de cette clé peut provoquer une erreur sur d’autres systèmes.Using this key may cause an error on other systems.

using namespace System;
using namespace Microsoft::Win32;
void PrintKeys( RegistryKey ^ rkey )
{
   
   // Retrieve all the subkeys for the specified key.
   array<String^>^names;
   try
   {
      names = rkey->GetSubKeyNames();
   }
   catch ( System::IO::IOException^ ) 
   {
      Console::WriteLine( "HKEY_DYN_DATA is not available on this machine." );
      return;
   }

   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_DYN_DATA
   // key in the registry of this machine.
   RegistryKey ^ rk = Registry::DynData;
   
   // 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_DYN_DATA
        // key in the registry of this machine.
        RegistryKey rk = Registry.DynData;

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

    static void PrintKeys(RegistryKey rkey) {

        // Retrieve all the subkeys for the specified key.
        String [] names;
        try {
            names = rkey.GetSubKeyNames();
        }
        catch (System.IO.IOException e) {
            Console.WriteLine("HKEY_DYN_DATA is not available on this machine.");
            return;
        }

        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_DYN_DATA
        ' key in the registry of this machine.
        Dim rk As RegistryKey = Registry.DynData
        
        ' 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()
        Try
            names = rkey.GetSubKeyNames()
        Catch ex As System.IO.IOException
            Console.WriteLine("HKEY_DYN_DATA is not available on this machine.")
            Exit Sub
        End Try
        
        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

Remarks

Le Registre Windows 98/Windows me prend en charge les données statiques (qui sont stockées sur disque dans le registre) et les données dynamiques (qui changent fréquemment, telles que les statistiques de performances).The Windows 98/Windows Me registry supports both static data (which is stored on disk in the registry) and dynamic data (which changes frequently, such as performance statistics). Cette zone de données dynamique est le mécanisme qui permet aux pilotes de périphériques virtuels (VxD) de fournir des données en temps réel aux applications Win32 qui peuvent s’exécuter à distance et localement.This dynamic data area is the mechanism that allows Virtual Device Drivers (VxDs) to provide real-time data to Win32 applications that can run remotely as well as locally. Il permet également au moniteur système de fournir des statistiques de performances sur les systèmes Windows 98/Windows me distants.It also allows the system monitor to provide performance statistics on remote Windows 98/Windows Me systems.

Les pilotes vxd ne sont pas limités aux données de performances.VxDs are not limited to performance data. Ils peuvent fournir toutes les données qu’ils souhaitent passer de l’anneau 0 à l’anneau 3 de manière efficace, sans monopoliser le processeur.They can provide any data they want to pass from Ring 0 to Ring 3 efficiently without monopolizing the CPU. Le registre prend en charge les données dynamiques en stockant un pointeur vers une fonction qui retourne une valeur (ou de nombreuses valeurs).The registry supports dynamic data by storing a pointer to a function that returns a value (or many values). Lorsqu’un appel de Registre interroge des valeurs associées à une clé dynamique, cette fonction est appelée pour retourner la ou les valeurs souhaitées.When a Registry call queries values associated with a dynamic key, that function is called to return the desired value or values.

Note

Les clés dynamiques ont été introduites dans Microsoft Windows 95 pour gérer les données dynamiques du Registre.Dynamic keys were introduced in Microsoft Windows 95 to handle dynamic Registry data. Ils sont uniquement pris en charge dans Windows 98/Windows Me.They are supported only in Windows 98/Windows Me.

Applies to