SHRegCreateUSKeyA-Funktion (shlwapi.h)

  • Artikel

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

Syntax

LSTATUS SHRegCreateUSKeyA(
  [in]           LPCSTR  pszPath,
  [in]           REGSAM  samDesired,
  [in, optional] HUSKEY  hRelativeUSKey,
  [out]          PHUSKEY phNewUSKey,
  [in]           DWORD   dwFlags
);

Parameter

[in] pszPath

Typ: LPCTSTR

Ein Zeiger auf eine NULL-endende Zeichenfolge, die den zu erstellenden oder zu öffnenden Unterschlüssel enthält. Wenn ein Wert mit diesem Namen bereits im Unterschlüssel vorhanden ist, wird er geöffnet.

[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 es sich bei pszPath um einen relativen Pfad handelt, wird der von diesem Schlüssel angegeben, relativ zu hRelativeUSKey. Wenn pszPath ein absoluter Pfad ist, legen Sie hRelativeUSKey auf NULL fest. Der Schlüssel wird dann je nach Wert von dwFlags unter HKEY_LOCAL_MACHINE oder HKEY_CURRENT_USER erstellt.

[out] phNewUSKey

Typ: PHUSKEY

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

[in] dwFlags

Art: DWORD

Der Basisschlüssel, unter dem der Schlüssel geöffnet werden soll. Dies kann mindestens einer der folgenden Werte sein.

SHREGSET_HKCU

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

SHREGSET_FORCE_HKCU

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

SHREGSET_HKLM

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

SHREGSET_FORCE_HKLM

Erstellen/öffnen Sie den Schlüssel unter HKEY_LOCAL_MACHINE. Erstellt einen Schlüssel, auch 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). Dieses Flag entspricht (SHREGSET_FORCE_HKCU | SHREGSET_HKLM).

Rückgabewert

Typ: LSTATUS

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

Hinweise

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 phNewUSKey zurückgegeben wird. Wenn Sie fertig sind, schließen Sie den benutzerspezifischen Registrierungsschlüssel mit SHRegCloseUSKey.

Hinweis

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

   
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)