SHRegOpenUSKeyW-Funktion (shlwapi.h)

  • Artikel

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

Syntax

LSTATUS SHRegOpenUSKeyW(
                 LPCWSTR pwzPath,
  [in]           REGSAM  samDesired,
  [in, optional] HUSKEY  hRelativeUSKey,
  [out]          PHUSKEY phNewUSKey,
  [in]           BOOL    fIgnoreHKCU
);

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 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.

[out] phNewUSKey

Typ: PHUSKEY

Ein Zeiger auf das Handle des geöffneten Schlüssels.

[in] fIgnoreHKCU

Typ: BOOL

Die Variable, die angibt, unter welchem Schlüssel gesucht werden soll. Bei Festlegung auf TRUE ignoriert SHRegOpenUSKeyHKEY_CURRENT_USER und gibt einen Wert aus HKEY_LOCAL_MACHINE zurück.

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

Hinweis

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