SHRegCreateUSKeyW-Funktion (shlwapi.h)

Artikel
11/20/2024

Erstellt oder öffnet einen Registrierungsunterschlüssel in einer benutzerspezifischen Unterstruktur (HKEY_CURRENT_USER oder HKEY_LOCAL_MACHINE).

Syntax

LSTATUS SHRegCreateUSKeyW(
                 LPCWSTR pwzPath,
  [in]           REGSAM  samDesired,
  [in, optional] HUSKEY  hRelativeUSKey,
  [out]          PHUSKEY phNewUSKey,
  [in]           DWORD   dwFlags
);

Parameter

pwzPath

TBD

[in] samDesired

Typ: REGSAM-

Der gewünschte Sicherheitszugriff. Weitere Informationen zum Sicherheitszugriff finden Sie unter REGSAM-.

[in, optional] hRelativeUSKey

Typ: HUSKEY

Der Schlüssel, der als Basis für relative Pfade verwendet werden soll. Wenn pszPath ein relativer Pfad ist, ist der von ihr festgelegte Schlüssel relativ zu hRelativeUSKey. Wenn pszPath ein absoluter Pfad ist, legen Sie hRelativeUSKey- auf NULL-fest. Der Schlüssel wird dann abhängig vom Wert dwFlagsunter HKEY_LOCAL_MACHINE oder HKEY_CURRENT_USERerstellt.

[out] phNewUSKey

Typ: PHUSKEY

Ein Zeiger auf einen HUSKEY-, der den Handle an den neuen Schlüssel empfängt.

[in] dwFlags

Typ: DWORD-

Der Basisschlüssel, unter dem der Schlüssel geöffnet werden soll. Dabei kann es sich um einen oder mehrere der folgenden Werte handeln.

SHREGSET_HKCU

Erstellen/öffnen Sie den Schlüssel unter HKEY_CURRENT_USER. Erstellt nur einen Schlüssel, wenn er leer ist.

SHREGSET_FORCE_HKCU

Erstellen/öffnen Sie den Schlüssel unter HKEY_CURRENT_USER. Erstellt auch dann einen Schlüssel, wenn er nicht leer ist.

SHREGSET_HKLM

Erstellen/öffnen Sie den Schlüssel unter HKEY_LOCAL_MACHINE. Erstellt nur einen Schlüssel, wenn er leer ist.

SHREGSET_FORCE_HKLM

Erstellen/öffnen Sie den Schlüssel unter HKEY_LOCAL_MACHINE. Erstellt auch dann einen Schlüssel, wenn er nicht leer ist.

SHREGSET_DEFAULT

Erstellen/öffnen Sie den Schlüssel sowohl unter HKEY_CURRENT_USER (erzwungen) als auch unter HKEY_LOCAL_MACHINE (nur wenn leer). Diese Kennzeichnung entspricht (SHREGSET_FORCE_HKCU | SHREGSET_HKLM).

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

Wenn Sie Werte in den neuen Schlüssel schreiben möchten, verwenden Sie SHRegWriteUSValue, um jeden Wert zu schreiben, und übergeben Sie das HUSKEY Handle, das über phNewUSKeyzurückgegeben wird. Wenn Sie fertig sind, schließen Sie den benutzerspezifischen Registrierungsschlüssel mit SHRegCloseUSKey.

Anmerkung

Der Header "shlwapi.h" definiert SHRegCreateUSKey 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)

Freigeben über