RegistryHive Énumération
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Représente les valeurs possibles pour un nœud de niveau supérieur sur un ordinateur étranger.
public enum class RegistryHive
public enum RegistryHive
[System.Serializable]
public enum RegistryHive
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public enum RegistryHive
type RegistryHive =
[<System.Serializable>]
type RegistryHive =
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type RegistryHive =
Public Enum RegistryHive
- Héritage
- Attributs
Champs
ClassesRoot | -2147483648 | Représente la clé de base HKEY_CLASSES_ROOT sur un autre ordinateur. Cette valeur peut être passée à la méthode OpenRemoteBaseKey(RegistryHive, String) afin d'ouvrir ce nœud à distance. |
CurrentConfig | -2147483643 | Représente la clé de base HKEY_CURRENT_CONFIG sur un autre ordinateur. Cette valeur peut être passée à la méthode OpenRemoteBaseKey(RegistryHive, String) afin d'ouvrir ce nœud à distance. |
CurrentUser | -2147483647 | Représente la clé de base HKEY_CURRENT_USER sur un autre ordinateur. Cette valeur peut être passée à la méthode OpenRemoteBaseKey(RegistryHive, String) afin d'ouvrir ce nœud à distance. |
DynData | -2147483642 | Représente la clé de base HKEY_DYN_DATA sur un autre ordinateur. Cette valeur peut être passée à la méthode OpenRemoteBaseKey(RegistryHive, String) afin d'ouvrir ce nœud à distance. |
LocalMachine | -2147483646 | Représente la clé de base HKEY_LOCAL_MACHINE sur un autre ordinateur. Cette valeur peut être passée à la méthode OpenRemoteBaseKey(RegistryHive, String) afin d'ouvrir ce nœud à distance. |
PerformanceData | -2147483644 | Représente la clé de base HKEY_PERFORMANCE_DATA sur un autre ordinateur. Cette valeur peut être passée à la méthode OpenRemoteBaseKey(RegistryHive, String) afin d'ouvrir ce nœud à distance. |
Users | -2147483645 | Représente la clé de base HKEY_USERS sur un autre ordinateur. Cette valeur peut être passée à la méthode OpenRemoteBaseKey(RegistryHive, String) afin d'ouvrir ce nœud à distance. |
Exemples
L’exemple de code suivant montre comment ouvrir une clé de Registre sur un ordinateur distant et énumérer les valeurs de la clé. L’ordinateur distant doit exécuter le service de Registre distant. Spécifiez le nom de l’ordinateur distant en tant qu’argument de ligne de commande lors de l’appel du programme.
using namespace System;
using namespace System::IO;
using namespace System::Security::Permissions;
using namespace Microsoft::Win32;
int main( int argc, char *argv[] )
{
RegistryKey ^ environmentKey;
// Check that an argument was specified when the
// program was invoked.
if ( argc == 1 )
{
Console::WriteLine( "Error: The name of the remote computer "
"must be specified as input on the command line." );
return -1;
}
try
{
// Open HKEY_CURRENT_USER\Environment on a remote computer.
environmentKey = RegistryKey::OpenRemoteBaseKey( RegistryHive::CurrentUser, gcnew String(argv[ 1 ]) )->OpenSubKey( "Environment" );
}
catch ( IOException^ e )
{
Console::WriteLine( "{0}: {1}", e->GetType()->Name, e->Message );
return -1;
}
// Print the values.
Console::WriteLine( "\nThere are {0} values for {1}.", environmentKey->ValueCount.ToString(), environmentKey->Name );
array<String^>^valueNames = environmentKey->GetValueNames();
for ( int i = 0; i < environmentKey->ValueCount; i++ )
{
Console::WriteLine( "{0,-20}: {1}", valueNames[ i ], environmentKey->GetValue( valueNames[ i ] )->ToString() );
}
// Close the registry key.
environmentKey->Close();
}
using System;
using System.IO;
using System.Security.Permissions;
using Microsoft.Win32;
class RemoteKey
{
static void Main(string[] args)
{
RegistryKey environmentKey;
string remoteName;
// Check that an argument was specified when the
// program was invoked.
if(args.Length == 0)
{
Console.WriteLine("Error: The name of the remote " +
"computer must be specified when the program is " +
"invoked.");
return;
}
else
{
remoteName = args[0];
}
try
{
// Open HKEY_CURRENT_USER\Environment
// on a remote computer.
environmentKey = RegistryKey.OpenRemoteBaseKey(
RegistryHive.CurrentUser, remoteName).OpenSubKey(
"Environment");
}
catch(IOException e)
{
Console.WriteLine("{0}: {1}",
e.GetType().Name, e.Message);
return;
}
// Print the values.
Console.WriteLine("\nThere are {0} values for {1}.",
environmentKey.ValueCount.ToString(),
environmentKey.Name);
foreach(string valueName in environmentKey.GetValueNames())
{
Console.WriteLine("{0,-20}: {1}", valueName,
environmentKey.GetValue(valueName).ToString());
}
// Close the registry key.
environmentKey.Close();
}
}
Imports System.IO
Imports System.Security.Permissions
Imports Microsoft.Win32
Public Class RemoteKey
Shared Sub Main(commandLineArgs As String())
Dim environmentKey As RegistryKey
' Check that an argument was specified when the
' program was invoked.
If commandLineArgs.Length = 0 Then
Console.WriteLine("Error: The name of the remote " & _
"computer must be specified as input on the " & _
"command line.")
Return
End If
Try
' Open HKEY_CURRENT_USER\Environment on a remote computer.
environmentKey = RegistryKey.OpenRemoteBaseKey( _
RegistryHive.CurrentUser, _
commandLineArgs(0)).OpenSubKey("Environment")
Catch ex As IOException
Console.WriteLine("{0}: {1}", _
ex.GetType().Name, ex.Message)
Return
End Try
' Print the values.
Console.WriteLine("\nThere are {0} values For {1}.", _
environmentKey.ValueCount.ToString(), environmentKey.Name)
For Each valueName As String In environmentKey.GetValueNames()
Console.WriteLine("{0,-20}: {1}", valueName, _
environmentKey.GetValue(valueName).ToString())
Next
' Close the registry key.
environmentKey.Close()
End Sub
End Class
Remarques
RegistryHive
les valeurs sont utilisées par la OpenRemoteBaseKey méthode pour représenter le nœud de niveau supérieur d’une clé demandée sur une machine étrangère (distante). Le nœud qui peut être ouvert avec la méthode OpenRemoteBaseKey doit être l’un de ces niveaux RegistryKeys
supérieurs . Un accès supplémentaire aux sous-clés du nœud identifié est disponible à l’aide des méthodes dans RegistryKey, tant que l’utilisateur dispose de l’autorisation appropriée.