SHRegEnumUSKeyW-Funktion (shlwapi.h)

  • Artikel

Listet die Unterschlüssel eines Registrierungsunterschlüssels in einer benutzerspezifischen Unterstruktur auf (HKEY_CURRENT_USER oder HKEY_LOCAL_MACHINE).

Syntax

LSTATUS SHRegEnumUSKeyW(
  [in]      HUSKEY          hUSKey,
  [in]      DWORD           dwIndex,
            LPWSTR          pwzName,
  [in, out] LPDWORD         pcchName,
  [in]      SHREGENUM_FLAGS enumRegFlags
);

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] dwIndex

Art: DWORD

Der Index des abzurufenden Unterschlüssels. Dieser Parameter sollte für den ersten Aufruf null und für nachfolgende Aufrufe inkrementiert sein.

pwzName

TBD

[in, out] pcchName

Typ: LPDWORD

Ein Zeiger auf ein DWORD, das bei einem Eintrag die Größe des Puffers bei pszName in Zeichen enthält. Beim Beenden enthält dies die Anzahl der Zeichen, die in pszName kopiert wurden.

[in] enumRegFlags

Typ: SHREGENUM_FLAGS

Eine SHREGENUM_FLAGS , die den Basisschlüssel angibt, in dem die Enumeration erfolgen soll.

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 Textbeschreibung des Fehlers abzurufen.

Hinweise

Hinweis

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