SHEnumValueA-Funktion (shlwapi.h)
Listet die Werte des angegebenen offenen Registrierungsschlüssels auf.
Syntax
LSTATUS SHEnumValueA(
[in] HKEY hkey,
[in] DWORD dwIndex,
PSTR pszValueName,
[in, out, optional] LPDWORD pcchValueName,
[out, optional] LPDWORD pdwType,
void *pvData,
[in, out, optional] LPDWORD pcbData
);
Parameter
[in] hkey
Typ: HKEY
Ein Handle für den derzeit geöffneten Schlüssel oder einen der folgenden vordefinierten Werte.
HKEY_CLASSES_ROOT
HKEY_CURRENT_CONFIG
HKEY_CURRENT_USER
HKEY_LOCAL_MACHINE
HKEY_PERFORMANCE_DATA
HKEY_USERS
[in] dwIndex
Art: DWORD
Der Index des abzurufenden Werts. Dieser Parameter sollte für den ersten Aufruf 0 sein und für nachfolgende Aufrufe inkrementiert werden.
pszValueName
Typ: LPTSTR
Die Adresse eines Zeichenpuffers, der den aufgezählten Wertnamen empfängt. Die Größe dieses Puffers wird in pcchValueName angegeben.
[in, out, optional] pcchValueName
Typ: LPDWORD
Die Adresse eines DWORD-Werts , das beim 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
Die Adresse eines DWORD-Werts , der den Datentyp des Werts empfängt. Dabei handelt es sich um dieselben Werte, die unter dem lpType-Parameter von RegEnumValue beschrieben werden.
pvData
Typ: LPVOID
Die Adresse eines Puffers, 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
Die Adresse eines DWORD-Elements , das beim Eintrag die Größe des Puffers bei pvData in Bytes enthält. Beim Beenden enthält dies die Anzahl der Bytes, die in pvData kopiert wurden.
Rückgabewert
Typ: LSTATUS
Gibt bei erfolgreicher Ausführung ERROR_SUCCESS oder andernfalls einen in Winerror.h definierten Nonzero-Fehlercode zurück. Sie können die FormatMessage-Funktion mit dem FORMAT_MESSAGE_FROM_SYSTEM Flag verwenden, um eine Textbeschreibung des Fehlers abzurufen.
Hinweise
Hinweis
Der shlwapi.h-Header definiert SHEnumValue als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code 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