RegConnectRegistryW-Funktion (winreg.h)
Stellt eine Verbindung mit einem vordefinierten Registrierungsschlüssel auf einem anderen Computer her.
Syntax
LSTATUS RegConnectRegistryW(
[in, optional] LPCWSTR lpMachineName,
[in] HKEY hKey,
[out] PHKEY phkResult
);
Parameter
[in, optional] lpMachineName
Der Name des Remotecomputers. Die Zeichenfolge hat die folgende Form:
\\Computername
Der Aufrufer muss Zugriff auf den Remotecomputer haben, andernfalls schlägt die Funktion fehl.
Wenn dieser Parameter NULL ist, wird der lokale Computername verwendet.
[in] hKey
Ein vordefiniertes Registrierungshandle. Bei diesem Parameter kann es sich um einen der folgenden vordefinierten Schlüssel auf dem Remotecomputer handeln.
HKEY_LOCAL_MACHINEHKEY_PERFORMANCE_DATAHKEY_USERS
[out] phkResult
Ein Zeiger auf eine Variable, die ein Schlüsselhandle empfängt, das das vordefinierte Handle auf dem Remotecomputer identifiziert.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.
Wenn die Funktion fehlschlägt, ist der Rückgabewert ein nichtzero-Fehlercode, der in Winerror.h definiert ist. Sie können die FormatMessage-Funktion mit dem flag FORMAT_MESSAGE_FROM_SYSTEM verwenden, um eine generische Beschreibung des Fehlers abzurufen.
Hinweise
RegConnectRegistry erfordert, dass der Remoteregistrierungsdienst auf dem Remotecomputer ausgeführt wird. Standardmäßig ist dieser Dienst so konfiguriert, dass er manuell gestartet wird. Um den Remoteregistrierungsdienst so zu konfigurieren, dass er automatisch gestartet wird, führen Sie Services.msc aus, und ändern Sie den Starttyp des Diensts in Automatisch.
Windows Server 2003 und Windows XP/2000: Der Remoteregistrierungsdienst ist so konfiguriert, dass er standardmäßig automatisch gestartet wird.
Wenn ein von RegConnectRegistry zurückgegebenes Handle nicht mehr benötigt wird, sollte es durch Aufrufen von RegCloseKey geschlossen werden.
Wenn der Computer einer Arbeitsgruppe beigetreten ist und die Richtlinie "Erzwingen von Netzwerkanmeldungen mithilfe lokaler Konten zur Authentifizierung als Gast" aktiviert ist, schlägt die Funktion fehl. Beachten Sie, dass diese Richtlinie standardmäßig aktiviert ist, wenn der Computer mit einer Arbeitsgruppe verbunden ist.
Wenn der aktuelle Benutzer keinen richtigen Zugriff auf den Remotecomputer hat, schlägt der Aufruf von RegConnectRegistry fehl. Um eine Verbindung mit einer Remoteregistrierung herzustellen, rufen Sie LogonUser mit LOGON32_LOGON_NEW_CREDENTIALS und ImpersonateLoggedOnUser auf, bevor Sie RegConnectRegistry aufrufen.
Windows 2000: Eine mögliche Problemumgehung besteht darin, eine Sitzung mit einer Administratorfreigabe wie IPC$ mit einem anderen Satz von Anmeldeinformationen einzurichten. Um andere Anmeldeinformationen als die des aktuellen Benutzers anzugeben, verwenden Sie die WNetAddConnection2-Funktion , um eine Verbindung mit der Freigabe herzustellen. Wenn Sie den Zugriff auf die Registrierung abgeschlossen haben, brechen Sie die Verbindung ab.
Windows XP Home Edition: Sie können diese Funktion nicht verwenden, um eine Verbindung mit einem Remotecomputer herzustellen, auf dem Windows XP Home Edition ausgeführt wird. Diese Funktion funktioniert mit dem Namen des lokalen Computers, auch wenn windows XP Home Edition ausgeführt wird, da dadurch die Authentifizierungsebene umgangen wird.
Hinweis
Der winreg.h-Header definiert RegConnectRegistry als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winreg.h (einschließlich Windows.h) |
| Bibliothek | Advapi32.lib |
| DLL | Advapi32.dll |