SHRegEnumUSValueA-Funktion (shlwapi.h)

Listet die Werte des angegebenen Registrierungsunterschlüssels in einer benutzerspezifischen Unterstruktur auf (HKEY_CURRENT_USER oder HKEY_LOCAL_MACHINE).

Syntax

LSTATUS SHRegEnumUSValueA(
  [in]                HUSKEY          hUSkey,
  [in]                DWORD           dwIndex,
  [out]               LPSTR           pszValueName,
  [in, out]           LPDWORD         pcchValueName,
  [out, optional]     LPDWORD         pdwType,
  [out, optional]     void            *pvData,
  [in, out, optional] LPDWORD         pcbData,
  [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 Werts. Dieser Parameter sollte für den ersten Aufruf null und für nachfolgende Aufrufe inkrementiert sein.

[out] pszValueName

Typ: LPTSTR

Ein Zeiger auf einen Zeichenpuffer, der den Namen des aufgezählten Werts empfängt. Die Größe dieses Puffers wird in pcchValueNameLen angegeben.

[in, out] pcchValueName

Typ: LPDWORD

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

[out, optional] pdwType

Typ: LPDWORD

Ein Zeiger auf ein DWORD , das den Datentyp des Werts empfängt. Dies sind die gleichen Werte wie die unter dem lpType-Parameter von RegEnumValue beschriebenen Werte.

[out, optional] pvData

Typ: void*

Ein Zeiger auf einen Puffer, der die Daten für den Werteintrag empfängt. Die Größe dieses Puffers wird in pcbData angegeben. Dieser Parameter kann NULL sein, wenn die Daten nicht erforderlich sind.

[in, out, optional] pcbData

Typ: LPDWORD

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

[in] enumRegFlags

Typ: SHREGENUM_FLAGS

Einer der SHREGENUM_FLAGS , der 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 SHRegEnumUSValue 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)