FindFirstUrlCacheEntryExA-Funktion (wininet.h)
Startet eine gefilterte Enumeration des Internetcaches.
Syntax
HANDLE FindFirstUrlCacheEntryExA(
[in] LPCSTR lpszUrlSearchPattern,
[in] DWORD dwFlags,
[in] DWORD dwFilter,
[in] GROUPID GroupId,
[out] LPINTERNET_CACHE_ENTRY_INFOA lpFirstCacheEntryInfo,
[in, out] LPDWORD lpcbCacheEntryInfo,
[out] LPVOID lpGroupAttributes,
[in, out] LPDWORD lpcbGroupAttributes,
[in] LPVOID lpReserved
);
Parameter
[in] lpszUrlSearchPattern
Ein Zeiger auf eine Zeichenfolge, die das Quellnamenmuster enthält, nach dem gesucht werden soll. Dieser Parameter kann nur auf "cookie:", "visited:" oder NULL festgelegt werden. Legen Sie diesen Parameter auf "cookie:" fest, um die Cookies aufzulisten, oder "visited:", um die URL-Verlaufseinträge im Cache aufzulisten. Wenn dieser Parameter NULL ist, gibt FindFirstUrlCacheEntryEx alle Inhaltseinträge im Cache zurück.
[in] dwFlags
Steuert die Enumeration. Derzeit sind keine Flags implementiert. Dieser Parameter muss auf 0 festgelegt werden.
[in] dwFilter
Eine Bitmaske, die den Typ des Cacheeintrags und seine Eigenschaften angibt. Die Cacheeintragstypen umfassen: Verlaufseinträge (URLHISTORY_CACHE_ENTRY), Cookieeinträge (COOKIE_CACHE_ENTRY) und normale zwischengespeicherte Inhalte (NORMAL_CACHE_ENTRY).
Dieser Parameter kann mindestens null der folgenden Eigenschaftsflags und Cachetypflags sein, die unten aufgeführt sind.
| Wert | Bedeutung |
|---|---|
|
Cacheeintrag für Cookies. |
|
Cacheeintragsdatei, die extern bearbeitet wurde. Dieser Cacheeintragstyp ist vom Auffangen ausgenommen. |
|
Normaler Cacheeintrag, der gelöscht werden kann, um Speicherplatz für neue Einträge freizugeben. |
|
Cacheeintrag für Teilantworten. |
|
Cacheeintrag für Kurznotizen, von der Löschung ausgenommen. |
|
Derzeit nicht implementiert. |
|
Derzeit nicht implementiert. |
|
Cacheeintrag für besuchte Links. |
[in] GroupId
ID der Cachegruppe, die aufgelistet werden soll. Legen Sie diesen Parameter auf Null fest, um alle Einträge aufzulisten, die nicht gruppiert sind.
[out] lpFirstCacheEntryInfo
Zeiger auf eine INTERNET_CACHE_ENTRY_INFO-Struktur , um die Cacheeintragsinformationen zu empfangen.
[in, out] lpcbCacheEntryInfo
Zeiger auf die Variable, die die Größe der Struktur angibt, auf die der lpFirstCacheEntryInfo-Parameter verweist, in Bytes.
[out] lpGroupAttributes
Dieser Parameter ist reserviert und muss NULL sein.
[in, out] lpcbGroupAttributes
Dieser Parameter ist reserviert und muss NULL sein.
[in] lpReserved
Dieser Parameter ist reserviert und muss NULL sein.
Rückgabewert
Gibt bei erfolgreicher Ausführung ein gültiges Handle zurück, andernfalls NULL. Rufen Sie GetLastError auf, um bestimmte Fehlerinformationen abzurufen. Wenn die Funktion keine übereinstimmenden Dateien findet, gibt GetLastError ERROR_NO_MORE_FILES zurück.
Hinweise
Das von FindFirstUrlCacheEntryEx zurückgegebene Handle wird in allen nachfolgenden Aufrufen von FindNextUrlCacheEntryEx verwendet. Am Ende der Enumeration sollte die Anwendung FindCloseUrlCache aufrufen.
Wie alle anderen Aspekte der WinINet-API kann diese Funktion nicht sicher innerhalb von DllMain oder den Konstruktoren und Destruktoren globaler Objekte aufgerufen werden.
Hinweis
Der wininet.h-Header definiert FindFirstUrlCacheEntryEx 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 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
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wininet.h |
| Bibliothek | Wininet.lib |
| DLL | Wininet.dll |