SHRegDeleteUSValueA-Funktion (shlwapi.h)

  • Artikel

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 für einen derzeit geöffneten Registrierungsunterschlüssel. Der Unterschlüssel muss mit dem zugriffsrecht KEY_SET_VALUE geöffnet worden sein. Weitere Informationen finden Sie unter Sicherheit und Zugriffsrechte für Registrierungsschlüssel.

Dieses Handle kann über die SHRegOpenUSKey-Funktion abgerufen werden.

[in] pszValue

Typ: LPCTSTR

Ein Zeiger auf die NULL-Zeichenfolge, die den zu entfernenden Wert benennt.

[in] delRegFlags

Typ: SHREGDEL_FLAGS

Eine der SHREGDEL_FLAGS , die angibt, aus welchem Basisschlüssel der Wert gelöscht wird.

Rückgabewert

Typ: LSTATUS

Gibt bei erfolgreicher Ausführung ERROR_SUCCESS oder andernfalls einen in Winerror.h definierten Nonzero-Fehlercode zurück. Sie können die FormatMessage-Funktion mit dem flag FORMAT_MESSAGE_FROM_SYSTEM verwenden, um eine generische Beschreibung des Fehlers abzurufen.

Hinweise

Hinweis

Der shlwapi.h-Header definiert SHRegDeleteUSValue 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 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

   
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 4.71 oder höher)

Weitere Informationen

SHRegDeleteEmptyUSKey