Share via

RegCopyTreeA-Funktion (winreg.h)

  • Artikel

Kopiert den angegebenen Registrierungsschlüssel zusammen mit seinen Werten und Unterschlüsseln in den angegebenen Zielschlüssel.

Syntax

LSTATUS RegCopyTreeA(
  [in]           HKEY   hKeySrc,
  [in, optional] LPCSTR lpSubKey,
  [in]           HKEY   hKeyDest
);

Parameter

[in] hKeySrc

Ein Handle für einen geöffneten Registrierungsschlüssel. Der Schlüssel muss mit dem zugriffsrecht KEY_READ geöffnet worden sein. Weitere Informationen finden Sie unter Sicherheit und Zugriffsrechte für Registrierungsschlüssel.

Dieses Handle wird von der RegCreateKeyEx - oder RegOpenKeyEx-Funktion zurückgegeben, oder es kann einer der vordefinierten Schlüssel sein.

[in, optional] lpSubKey

Der Name des Schlüssels. Dieser Schlüssel muss ein Unterschlüssel des Schlüssels sein, der durch den hKeySrc-Parameter identifiziert wird. Dieser Parameter kann auch NULL sein.

[in] hKeyDest

Ein Handle für den Zielschlüssel. Der aufrufende Prozess muss KEY_CREATE_SUB_KEY Zugriff auf den Schlüssel haben.

Dieses Handle wird von der RegCreateKeyEx - oder RegOpenKeyEx-Funktion zurückgegeben, oder es kann einer der vordefinierten Schlüssel sein.

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

Diese Funktion kopiert auch den Sicherheitsdeskriptor für den Schlüssel.

Um eine Anwendung zu kompilieren, die diese Funktion verwendet, definieren Sie _WIN32_WINNT als 0x0600 oder höher. Weitere Informationen finden Sie unter Verwenden der Windows-Header.

Hinweis

Der winreg.h-Header definiert RegCopyTree 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

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winreg.h (einschließlich Windows.h)
Bibliothek Advapi32.lib
DLL Advapi32.dll

Weitere Informationen

Registrierungsfunktionen