SHRegEnumUSKeyA-Funktion (shlwapi.h)
Listet die Unterschlüssel eines Registrierungsunterschlüssels in einer benutzerspezifischen Unterstruktur auf (HKEY_CURRENT_USER oder HKEY_LOCAL_MACHINE).
Syntax
LSTATUS SHRegEnumUSKeyA(
[in] HUSKEY hUSKey,
[in] DWORD dwIndex,
[out] LPSTR pszName,
[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 0 sein und für nachfolgende Aufrufe inkrementiert werden.
[out] pszName
Typ: LPTSTR
Ein Zeiger auf einen Zeichenpuffer, der den aufgezählten Schlüsselnamen empfängt.
[in, out] pcchName
Typ: LPDWORD
Ein Zeiger auf ein DWORD, das beim 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 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 SHRegEnumUSKey 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) |