RegistryKey.OpenRemoteBaseKey Metode

Referensi

Definisi

Ruang nama:: Microsoft.Win32

Rakitan:: Microsoft.Win32.Registry.dll

Rakitan:: mscorlib.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Membuka T:Microsoft.Win32.RegistryKey baru yang mewakili kunci yang diminta pada komputer jarak jauh, dengan opsi tampilan registri yang ditentukan.

Overload

OpenRemoteBaseKey(RegistryHive, String)	Membuka baru RegistryKey yang mewakili kunci yang diminta pada komputer jarak jauh.
OpenRemoteBaseKey(RegistryHive, String, RegistryView)	Membuka kunci registri baru yang mewakili kunci yang diminta pada komputer jarak jauh dengan tampilan yang ditentukan.

OpenRemoteBaseKey(RegistryHive, String)

Sumber:: RegistryKey.cs

Membuka baru RegistryKey yang mewakili kunci yang diminta pada komputer jarak jauh.

public:
 static Microsoft::Win32::RegistryKey ^ OpenRemoteBaseKey(Microsoft::Win32::RegistryHive hKey, System::String ^ machineName);

public static Microsoft.Win32.RegistryKey OpenRemoteBaseKey (Microsoft.Win32.RegistryHive hKey, string machineName);

static member OpenRemoteBaseKey : Microsoft.Win32.RegistryHive * string -> Microsoft.Win32.RegistryKey

Public Shared Function OpenRemoteBaseKey (hKey As RegistryHive, machineName As String) As RegistryKey

Parameter

hKey: RegistryHive

HKEY yang akan dibuka, dari RegistryHive enumerasi.

machineName: String

Mesin jarak jauh.

Mengembalikan

RegistryKey

Kunci registri yang diminta.

Pengecualian

ArgumentException

hKey tidak valid.

IOException

machineName tidak ditemukan.

ArgumentNullException

machineNameadalah null.

SecurityException

Pengguna tidak memiliki izin yang tepat untuk melakukan operasi ini.

UnauthorizedAccessException

Pengguna tidak memiliki hak registri yang diperlukan.

Contoh

Contoh kode berikut menunjukkan cara membuka kunci registri di komputer jarak jauh dan menghitung nilai kunci. Komputer jarak jauh harus menjalankan layanan registri jarak jauh. Tentukan nama komputer jarak jauh sebagai argumen baris perintah saat memanggil 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

Keterangan

Registri komputer lokal dibuka jika machineName adalah String.Empty. Kunci yang diminta harus merupakan kunci akar pada komputer jarak jauh, dan diidentifikasi oleh nilai yang sesuai RegistryHive .

Agar kunci dibuka dari jarak jauh, komputer server dan klien harus menjalankan layanan registri jarak jauh, dan mengaktifkan administrasi jarak jauh.

Lihat juga

Berlaku untuk

OpenRemoteBaseKey(RegistryHive, String, RegistryView)

Sumber:: RegistryKey.cs

Membuka kunci registri baru yang mewakili kunci yang diminta pada komputer jarak jauh dengan tampilan yang ditentukan.

public:
 static Microsoft::Win32::RegistryKey ^ OpenRemoteBaseKey(Microsoft::Win32::RegistryHive hKey, System::String ^ machineName, Microsoft::Win32::RegistryView view);

public static Microsoft.Win32.RegistryKey OpenRemoteBaseKey (Microsoft.Win32.RegistryHive hKey, string machineName, Microsoft.Win32.RegistryView view);

[System.Runtime.InteropServices.ComVisible(false)]
public static Microsoft.Win32.RegistryKey OpenRemoteBaseKey (Microsoft.Win32.RegistryHive hKey, string machineName, Microsoft.Win32.RegistryView view);

static member OpenRemoteBaseKey : Microsoft.Win32.RegistryHive * string * Microsoft.Win32.RegistryView -> Microsoft.Win32.RegistryKey

[<System.Runtime.InteropServices.ComVisible(false)>]
static member OpenRemoteBaseKey : Microsoft.Win32.RegistryHive * string * Microsoft.Win32.RegistryView -> Microsoft.Win32.RegistryKey

Public Shared Function OpenRemoteBaseKey (hKey As RegistryHive, machineName As String, view As RegistryView) As RegistryKey

Parameter

hKey: RegistryHive

HKEY yang akan dibuka dari RegistryHive enumerasi.

machineName: String

Mesin jarak jauh.

view: RegistryView

Tampilan registri yang akan digunakan.

Mengembalikan

RegistryKey

Kunci registri yang diminta.

Atribut: ComVisibleAttribute

Pengecualian

ArgumentException

hKey atau view tidak valid.

IOException

machineName tidak ditemukan.

ArgumentNullException

machineNameadalah null.

UnauthorizedAccessException

Pengguna tidak memiliki hak registri yang diperlukan.

SecurityException

Pengguna tidak memiliki izin yang diperlukan untuk melakukan operasi ini.

Keterangan

Registri komputer lokal dibuka jika machineName adalah String.Empty. Kunci yang diminta harus merupakan kunci akar pada komputer jarak jauh, dan diidentifikasi oleh nilai yang sesuai RegistryHive .

Agar kunci dibuka dari jarak jauh, komputer server dan klien harus menjalankan layanan registri jarak jauh, dan mengaktifkan administrasi jarak jauh.

Pada Windows versi 64-bit, bagian registri disimpan secara terpisah untuk aplikasi 32-bit dan 64-bit. Ada tampilan 32-bit untuk aplikasi 32-bit dan tampilan 64-bit untuk aplikasi 64-bit. Jika view adalah Registry64 tetapi komputer jarak jauh menjalankan sistem operasi 32-bit, kunci yang dikembalikan akan menggunakan Registry32 tampilan .

Berlaku untuk

Bagikan melalui

RegistryKey.OpenRemoteBaseKey Metode

Definisi

Overload

OpenRemoteBaseKey(RegistryHive, String)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

OpenRemoteBaseKey(RegistryHive, String, RegistryView)

Parameter

Mengembalikan

Pengecualian

Keterangan

Berlaku untuk

Sumber Daya Tambahan: