SHRegDeleteUSValueA-Funktion (shlwapi.h)
Löscht einen Registrierungsunterschlüsselwert in einer benutzerspezifischen Unterstruktur (HKEY_CURRENT_USER oder HKEY_LOCAL_MACHINE).
Syntax
LSTATUS SHRegDeleteUSValueA(
[in] HUSKEY hUSKey,
[in] LPCSTR pszValue,
[in] SHREGDEL_FLAGS delRegFlags
);
Parameter
[in] hUSKey
Typ: HUSKEY
Ein Handle zu einem aktuell geöffneten Registrierungsunterschlüssel. Der Unterschlüssel muss mit dem KEY_SET_VALUE Zugriffsrecht geöffnet worden sein. Weitere Informationen finden Sie unter Registry Key Security and Access Rights.
Dieses Handle kann über die SHRegOpenUSKey--Funktion abgerufen werden.
[in] pszValue
Typ: LPCTSTR-
Ein Zeiger auf die mit Null beendete Zeichenfolge, die den zu entfernenden Wert benennt.
[in] delRegFlags
Typ: SHREGDEL_FLAGS
Einer der SHREGDEL_FLAGS, der angibt, aus welchem Basisschlüssel der Wert gelöscht wird.
Rückgabewert
Typ: LSTATUS-
Gibt ERROR_SUCCESS zurück, wenn dies erfolgreich ist, oder wenn der Fehlercode nicht in Winerror.h definiert ist. Sie können die FormatMessage--Funktion mit dem FORMAT_MESSAGE_FROM_SYSTEM Flag verwenden, um eine generische Beschreibung des Fehlers abzurufen.
Bemerkungen
Anmerkung
Der Header "shlwapi.h" definiert SHRegDeleteUSValue 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 |
|---|---|
| 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 4.71 oder höher) |