RegConnectRegistryW

別のコンピュータ上の定義済みレジストリキーへの接続を確立する。(Unicode)

RegConnectRegistryW lpMachineName, hKey, phkResult

lpMachineName : [wstr] リモートコンピュータの名前。文字列は次の形式である:
hKey : [intptr] 定義済みのレジストリハンドル。リモートコンピュータ上の以下の定義済みキーのいずれかを指定できる。
phkResult : [intptr] リモートコンピュータ上の定義済みハンドルを識別するキーハンドルを受け取る変数へのポインタ。

(プラグイン / モジュール : advapi32.dll)

解説

別のコンピュータ上の定義済みレジストリキーへの接続を確立する。(Unicode)

[戻り値]
関数が成功した場合、戻り値は ERROR_SUCCESS となる。関数が失敗した場合、戻り値は Winerror.h で定義された 0
以外のエラーコードとなる。FormatMessage 関数に FORMAT_MESSAGE_FROM_SYSTEM
フラグを指定して呼び出すと、エラーの一般的な説明を取得できる。

[備考]
RegConnectRegistry はリモートコンピュータ上で Remote Registry
サービスが実行されていることを要求する。既定では、このサービスは手動起動で構成されている。Remote Registry
サービスを自動起動するように構成するには、Services.msc を実行してサービスのスタートアップ種別を自動に変更する。Windows
Server 2003 および Windows XP/2000 では、Remote Registry
サービスは既定で自動起動するよう構成されている。RegConnectRegistry
が返したハンドルが不要になった場合、RegCloseKey
を呼び出して閉じるべきである。コンピュータがワークグループに参加しており、「ローカルアカウントの共有とセキュリティモデル」ポリシーで「ローカルアカウントへのネットワークログオンをゲストとして認証する」が有効になっている場合、関数は失敗する。このポリシーはコンピュータがワークグループに参加している場合、既定で有効になる点に注意のこと。現在のユーザがリモートコンピュータへの適切なアクセス権を持っていない場合、RegConnectRegistry
の呼び出しは失敗する。リモートレジストリに接続するには、RegConnectRegistry を呼び出す前に
LOGON32_LOGON_NEW_CREDENTIALS を指定して LogonUser
を呼び出し、ImpersonateLoggedOnUser を呼び出す。Windows 2000 では、別の資格情報を使用して IPC$
などの管理共有にセッションを確立する回避策が考えられる。現在のユーザ以外の資格情報を指定するには、WNetAddConnection2
関数を使用して共有に接続する。レジストリへのアクセスが完了したら、接続をキャンセルする。Windows XP Home Edition
では、この関数を使用して Windows XP Home Edition
を実行しているリモートコンピュータに接続することはできない。この関数は、Windows XP Home Edition
を実行しているローカルコンピュータ名でも動作する。これは認証層をバイパスするためである。
> [!NOTE] > winreg.h ヘッダは RegConnectRegistry をエイリアスとして定義しており、UNICODE
プリプロセッサ定数の定義に基づいて ANSI または Unicode
版を自動的に選択する。エンコーディングに中立なエイリアスをエンコーディング中立でないコードと混在させると、コンパイル時または実行時エラーとなる可能性がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照のこと。

情報