SHCopyKeyA-Funktion (shlwapi.h)

  • Artikel

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

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

Art: DWORD

Reserviert. Muss den Wert 0 (null) haben.

Rückgabewert

Typ: LSTATUS

Gibt bei erfolgreicher Ausführung ERROR_SUCCESS oder andernfalls einen der in Winerror.h definierten Fehlercodes ungleich null zurück. Verwenden Sie FormatMessage mit dem flag FORMAT_MESSAGE_FROM_SYSTEM, um eine generische Beschreibung des Fehlers abzurufen.

Hinweise

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

Hinweis

Der shlwapi.h-Header definiert SHCopyKey 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 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
Unterstützte Mindestversion (Client) Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlwapi.h
Bibliothek Shlwapi.lib
DLL Shlwapi.dll (Version 5.0 oder höher)