SHCopyKeyA-Funktion (shlwapi.h)
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
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) |