SHCopyKeyA-Funktion (shlwapi.h)

Artikel
11/20/2024

Kopiert rekursiv die Unterschlüssel und Werte des Quellunterschlüssels in den Zielschlüssel. SHCopyKey kopiert nicht die Sicherheitsattribute der Schlüssel.

Syntax

LSTATUS SHCopyKeyA(
  [in]           HKEY   hkeySrc,
  [in, optional] LPCSTR pszSrcSubKey,
  [in]           HKEY   hkeyDest,
                 DWORD  fReserved
);

Parameter

[in] hkeySrc

Typ: HKEY-

Ein Handle für den Quellschlüssel (z. B. HKEY_CURRENT_USER).

[in, optional] pszSrcSubKey

Typ: LPCTSTR-

Der Unterschlüssel, dessen Unterschlüssel und Werte kopiert werden sollen.

[in] hkeyDest

Typ: HKEY-

Der Zielschlüssel.

fReserved

Typ: DWORD-

Reserviert. Muss 0 sein.

Rückgabewert

Typ: LSTATUS-

Gibt ERROR_SUCCESS zurück, wenn dies erfolgreich ist, oder eine der in Winerror.h definierten Fehlercodes, die in Winerror.h definiert sind. Verwenden Sie FormatMessage- mit dem FORMAT_MESSAGE_FROM_SYSTEM Flag, um eine allgemeine Beschreibung des Fehlers abzurufen.

Bemerkungen

Wichtig Diese Funktion dupliziert nicht die Sicherheitsattribute der Schlüssel und Werte, die sie kopiert. Vielmehr sind alle Sicherheitsattribute im Zielschlüssel die Standardattribute.

Anmerkung

Der Header "shlwapi.h" definiert SHCopyKey als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, 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
mindestens unterstützte Client-	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	shlwapi.h
Library	Shlwapi.lib
DLL-	Shlwapi.dll (Version 5.0 oder höher)

Freigeben über