RegConnectRegistry

Declare Function Api_RegConnectRegistry& Lib "advapi32" Alias "RegConnectRegistryA" (ByVal lpMachineName$, ByVal hKey&, phkResult&)

Declare Function RegConnectRegistry Lib "advapi32" Alias "RegConnectRegistryA" (ByVal lpMachineName As String, ByVal hKey As Long, phkResult As Long) As Long

ほかのコンピュータ上の定義済みレジストリハンドルとの接続を確立する。

パラメータ
lpMachineName
    リモートコンピュータの名前を保持している、NULL で終わる文字列へのポインタを指定する。この文字列は、次の形式で指定する。
    \\computername
    NULL を指定すると、ローカルコンピュータの名前が使用される。
hKey
    リモートコンピュータ上で定義済みのレジストリハンドルを指定する。次の値のいずれかを指定する。
    HKEY_LOCAL_MACHINE
    HKEY_USERS
    Windows NT/2000：リモートコンピュータが Windows NT または Windows 2000 を実行している場合、HKEY_PERFORMANCE_DATA

    も利用可能である。
    Windows 95/98：リモートコンピュータが Windows 95 または Windows 98 を実行している場合、HKEY_DYN_DATA と

    HKEY_CURRENT_CONFIG も利用可能である。
    このパラメータでは、HKEY_CLASSES_ROOT や HKEY_CURRENT_USER は指定できない。
phkResult
    1 個の変数へのポインタを指定する。関数から制御が返ると、この変数に、リモートコンピュータ上の定義済みハンドルを識別する、キーの

    ハンドルが格納される。
　

戻り値
    関数が成功すると、ERROR_SUCCESS が返る。
    関数が失敗すると、Winerror.h ヘッダーファイル内で定義されている、0 以外のエラーコードが返る。

    FORMAT_MESSAGE_FROM_SYSTEM フラグを指定して FormatMessage 関数を呼び出すと、エラーの一般的な説明を取得できる。

解説
    RegConnectRegistry 関数を使って取得したハンドルが不要になったら、RegCloseKey 関数を使って閉じてください。
    Windows 95/98：レジストリのサブキー名、およびレジストリエントリ名の長さは、最大 255 文字である。
    レジストリエディタ（Regedt32.exe または Regedit.exe）は、ここで言う「レジストリエントリ」を「値」と呼んでいる。

    どちらも同じものを意味していて、「名前」（レジストリエントリ名）と「データ」（レジストリエントリのデータ）で構成されている。
    Windows 95/98：Windows 95 または Windows 98 で RegConnectRegistry 関数を使うには、Microsoft Remote Registry サービスをイン

    ストールしなければならない。このサービスがインストールされていない状態で関数を呼び出すと、ERROR_DLL_INIT_FAILED が返る。

    Microsoft Remote Registry サービスをインストールするには、次の手順に従う。
    Microsoft Remote Registry サービスをインストールする方法
    1.［コントロールパネル］の［ネットワーク］をダブルクリックし、［追加］ボタンをクリックする。
    2.［ネットワークコンポーネントの選択］ダイアログボックスで、［サービス］をダブルクリックする。
    3.［ネットワークサービスの選択］ダイアログボックスで、［ディスク使用］ボタンをクリックする。
    4.［ディスクからインストール］ダイアログボックスで、［参照］ボタンをクリックする。［開く］ダイアログボックスで Windows 95 の

        CD-ROM のドライブ名と、\ADMIN\NETTOOLS\REMOTREG というパス名（Windows 98 では

        \TOOLS\RESKIT\NETADMIN\REMOTREG）を選択し、［OK］ボタンをクリックする。
    5.［ディスクからインストール］ダイアログボックスで、［OK］ボタンをクリックする。
    6.［ネットワークサービスの選択］ダイアログボックスで、［Microsoft リモートレジストリ］をクリックし、［OK］ボタンをクリックする。
    追加のファイルの場所を指定するよう指示された場合は、ネットワークディレクトリか Windows 95 の CD-ROM の適切なパス

    （\WIN95 など）を指定する。