RegistryHive 枚举

定义

表示外部计算机上的顶级节点的可能值。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
继承
RegistryHive
属性

字段

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 -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 -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 -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 -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 -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 -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

注解

RegistryHiveOpenRemoteBaseKey方法使用值来表示外部 (远程) 计算机上请求的键的顶级节点。RegistryHive values are used by the OpenRemoteBaseKey method to represent the top-level node of a requested key on a foreign (remote) machine. 可以用 OpenRemoteBaseKey 方法打开的节点必须是其中一个顶级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.

适用于

另请参阅