RegistryKey.OpenRemoteBaseKey メソッド

リファレンス

定義

名前空間:: Microsoft.Win32

アセンブリ:: Microsoft.Win32.Registry.dll

アセンブリ:: mscorlib.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

リモートコンピューター上にある要求されたキーを表す新しい T:Microsoft.Win32.RegistryKey を、指定されたレジストリビューオプションで開きます。

オーバーロード

OpenRemoteBaseKey(RegistryHive, String)	リモートコンピューター上にある要求されたキーを表す新しい RegistryKey を開きます。
OpenRemoteBaseKey(RegistryHive, String, RegistryView)	リモートコンピューター上にある要求されたキーを表す新しいレジストリキーを、指定されたビューで開きます。

OpenRemoteBaseKey(RegistryHive, String)

ソース:: RegistryKey.cs

リモートコンピューター上にある要求されたキーを表す新しい RegistryKey を開きます。

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

パラメーター

hKey: RegistryHive

RegistryHive 列挙体の開く対象の HKEY。

machineName: String

リモートコンピューター。

戻り値

RegistryKey

要求されたレジストリキー。

例外

ArgumentException

hKey が無効です。

IOException

machineName が見つかりません。

ArgumentNullException

machineName が nullです。

SecurityException

ユーザーに、この操作を実行するための十分なアクセス許可がありません。

UnauthorizedAccessException

ユーザーに、必要なレジストリ権限がありません。

例

次のコード例は、リモートコンピューターでレジストリキーを開き、キーの値を列挙する方法を示しています。リモートコンピューターがリモートレジストリサービスを実行している必要があります。プログラムを呼び出すときに、リモートコンピューターの名前をコマンドライン引数として指定します。

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

注釈

がの場合machineNameString.Empty、ローカルコンピューターレジストリが開かれます。要求されたキーはリモートコンピューター上のルートキーである必要があり、適切な RegistryHive 値によって識別されます。

キーをリモートで開くには、サーバーとクライアントの両方のマシンがリモートレジストリサービスを実行し、リモート管理を有効にする必要があります。

こちらもご覧ください

適用対象

OpenRemoteBaseKey(RegistryHive, String, RegistryView)

ソース:: RegistryKey.cs

リモートコンピューター上にある要求されたキーを表す新しいレジストリキーを、指定されたビューで開きます。

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

パラメーター

hKey: RegistryHive

RegistryHive 列挙体の開く対象の HKEY。

machineName: String

リモートコンピューター。

view: RegistryView

使用するレジストリビュー。

戻り値

RegistryKey

要求されたレジストリキー。

属性: ComVisibleAttribute

例外

ArgumentException

hKey または view が無効です。

IOException

machineName が見つかりません。

ArgumentNullException

machineName が nullです。

UnauthorizedAccessException

ユーザーに、必要なレジストリ権限がありません。

SecurityException

ユーザーに、この操作を実行するための必要なアクセス許可がありません。

注釈

64 ビットバージョンの Windows では、レジストリの一部が 32 ビットアプリケーションと 64 ビットアプリケーション用に個別に格納されます。 32 ビットアプリケーションには 32 ビットビュー、64 ビットアプリケーションには 64 ビットビューがあります。がRegistry64、リモートコンピューターで 32 ビットオペレーティングシステムが実行されている場合view、返されるキーはビューをRegistry32使用します。

適用対象

次の方法で共有

RegistryKey.OpenRemoteBaseKey メソッド

定義

オーバーロード

OpenRemoteBaseKey(RegistryHive, String)

パラメーター

戻り値

例外

例

注釈

こちらもご覧ください

適用対象

OpenRemoteBaseKey(RegistryHive, String, RegistryView)

パラメーター

戻り値

例外

注釈

適用対象

その他のリソース