SHRegSetValue-Funktion (shlwapi.h)

Artikel
08/26/2023

Wird nicht unterstützt.

Festlegen eines Registrierungswerts.

Verwenden Sie RegSetValue an seiner Stelle.

Syntax

LSTATUS SHRegSetValue(
  [in] HKEY    hkey,
  [in] LPCWSTR pszSubKey,
  [in] LPCWSTR pszValue,
  [in] SRRF    srrfFlags,
  [in] DWORD   dwType,
  [in] LPCVOID pvData,
  [in] DWORD   cbData
);

Parameter

[in] hkey

Typ: HKEY

Ein Handle für den derzeit geöffneten Schlüssel oder einen der folgenden vordefinierten Werte.

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_PERFORMANCE_DATA

HKEY_USERS

[in] pszSubKey

Typ: LPCWSTR

Ein Zeiger auf eine NULL-Zeichenfolge, die den relativen Pfad von hkey zum Unterschlüssel angibt, aus dem der Wert abgerufen werden soll. Dieser Parameter kann NULL oder eine leere Zeichenfolge sein. In diesem Fall werden die Daten vom Speicherort "hkey " abgerufen.

[in] pszValue

Typ: LPCWSTR

Ein Zeiger auf eine NULL-Zeichenfolge, die den Namen des Werts enthält. Dieser Parameter kann NULL oder eine leere Zeichenfolge sein. In diesem Fall werden die Daten aus dem Standardwert abgerufen.

[in] srrfFlags

Typ: SRRF

Mindestens eines der SRRF-Flags , das die festzulegenden Daten einschränkt. Es muss mindestens ein Typeinschränkungswert (SRRF_RT) angegeben werden.

[in] dwType

Art: DWORD

Das DWORD , das den Typ der in dem festzulegenden Wert gespeicherten Daten angibt. Bei Verwendung von Standardwerten ist die Eingabe dwType der Typ des Standardwerts. Mögliche Werte finden Sie unter Registrierungsdatentypen. Wenn das SRRF_NOEXPAND-Flag nicht festgelegt ist, werden REG_EXPAND_SZ Typen automatisch erweitert und als REG_SZ zurückgegeben. Wenn keine Typinformationen erforderlich sind, kann dieser Parameter NULL sein.

[in] pvData

Typ: LPCVOID

Ein Zeiger auf einen Puffer, der die Daten des Werts enthält. Dieser Parameter kann NULL sein, wenn die Daten nicht benötigt werden.

[in] cbData

Art: DWORD

Die Größe des Quelldatenpuffers pvData in Bytes. Dieser Wert kann nur NULL sein, wenn pvDataNULL ist.

Rückgabewert

Typ: LONG

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 FORMAT_MESSAGE_FROM_SYSTEM Flag verwenden, um eine generische Beschreibung des Fehlers abzurufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlwapi.h (include Shlwapi.h)
DLL	Shlwapi.dll

Weitere Informationen

RegSetKeyValue

Freigeben über