RegistryHive RegistryHive RegistryHive RegistryHive Enum

Определение

Представляет возможные значения для узла верхнего уровня на чужом компьютере.Represents the possible values for a top-level node on a foreign machine.

public enum class RegistryHive
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public enum RegistryHive
type RegistryHive = 
Public Enum RegistryHive
Наследование
Атрибуты

Поля

ClassesRoot ClassesRoot ClassesRoot ClassesRoot -2147483648

Представляет базовый раздел HKEY_CLASSES_ROOT на другом компьютере.Represents the HKEY_CLASSES_ROOT base key on another computer. Для удаленного открытия данного узла это значение может быть передано в метод OpenRemoteBaseKey(RegistryHive, String).This value can be passed to the OpenRemoteBaseKey(RegistryHive, String) method, to open this node remotely.

CurrentConfig CurrentConfig CurrentConfig CurrentConfig -2147483643

Представляете базовый раздел HKEY_CURRENT_CONFIG на другом компьютере.Represents the HKEY_CURRENT_CONFIG base key on another computer. Для удаленного открытия данного узла это значение может быть передано в метод OpenRemoteBaseKey(RegistryHive, String).This value can be passed to the OpenRemoteBaseKey(RegistryHive, String) method, to open this node remotely.

CurrentUser CurrentUser CurrentUser CurrentUser -2147483647

Представляете базовый раздел HKEY_CURRENT_USER на другом компьютере.Represents the HKEY_CURRENT_USER base key on another computer. Для удаленного открытия данного узла это значение может быть передано в метод OpenRemoteBaseKey(RegistryHive, String).This value can be passed to the OpenRemoteBaseKey(RegistryHive, String) method, to open this node remotely.

DynData DynData DynData DynData -2147483642

Представляете базовый раздел HKEY_DYN_DATA на другом компьютере.Represents the HKEY_DYN_DATA base key on another computer. Для удаленного открытия данного узла это значение может быть передано в метод OpenRemoteBaseKey(RegistryHive, String).This value can be passed to the OpenRemoteBaseKey(RegistryHive, String) method, to open this node remotely.

LocalMachine LocalMachine LocalMachine LocalMachine -2147483646

Представляете базовый раздел HKEY_LOCAL_MACHINE на другом компьютере.Represents the HKEY_LOCAL_MACHINE base key on another computer. Для удаленного открытия данного узла это значение может быть передано в метод OpenRemoteBaseKey(RegistryHive, String).This value can be passed to the OpenRemoteBaseKey(RegistryHive, String) method, to open this node remotely.

PerformanceData PerformanceData PerformanceData PerformanceData -2147483644

Представляете базовый раздел HKEY_PERFORMANCE_DATA на другом компьютере.Represents the HKEY_PERFORMANCE_DATA base key on another computer. Для удаленного открытия данного узла это значение может быть передано в метод OpenRemoteBaseKey(RegistryHive, String).This value can be passed to the OpenRemoteBaseKey(RegistryHive, String) method, to open this node remotely.

Users Users Users Users -2147483645

Представляете базовый раздел HKEY_USERS на другом компьютере.Represents the HKEY_USERS base key on another computer. Для удаленного открытия данного узла это значение может быть передано в метод OpenRemoteBaseKey(RegistryHive, String).This value can be passed to the OpenRemoteBaseKey(RegistryHive, String) method, to open this node remotely.

Примеры

В следующем примере кода показано, как открыть раздел реестра на удаленном компьютере и перечислить значения ключа.The following code example shows how to open a registry key on a remote computer and enumerate the values of the key. На удаленном компьютере должна быть запущена служба удаленного реестра.The remote computer must be running the remote registry service. При вызове программы укажите имя удаленного компьютера в виде аргумента командной строки.Specify the name of the remote computer as a command-line argument when invoking the program.

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

Комментарии

RegistryHiveзначения используются OpenRemoteBaseKey методом для представления узла верхнего уровня запрошенного ключа на внешнем (удаленном) компьютере.RegistryHive values are used by the OpenRemoteBaseKey method to represent the top-level node of a requested key on a foreign (remote) machine. Узел, который можно открыть с помощью метода Опенремотебасекэй, должен быть одним из этих элементов верхнего уровня RegistryKeys.The node that can be opened with the OpenRemoteBaseKey method must be one of these top-level RegistryKeys. Дополнительный доступ к подразделам идентифицированного узла доступен с помощью методов в RegistryKeyсреде, если пользователь имеет соответствующее разрешение.Further access to the subkeys of the identified node is available using methods in RegistryKey, so long as the user has appropriate permission.

Применяется к

Дополнительно