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 Microsoft.VisualBasic
Imports System
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. 可以使用 OpenRemoteBaseKey 方法打开的节点必须是这些顶级之一RegistryKeysThe 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.

适用于

另请参阅