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) |
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für