Share via

FindFirstUrlCacheEntryExW-Funktion (wininet.h)

  • Artikel

Startet eine gefilterte Enumeration des Internetcaches.

Syntax

HANDLE FindFirstUrlCacheEntryExW(
  [in]      LPCWSTR                      lpszUrlSearchPattern,
  [in]      DWORD                        dwFlags,
  [in]      DWORD                        dwFilter,
  [in]      GROUPID                      GroupId,
  [out]     LPINTERNET_CACHE_ENTRY_INFOW 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
COOKIE_CACHE_ENTRY
 Cacheeintrag für Cookies.
EDITED_CACHE_ENTRY
 Cacheeintragsdatei, die extern bearbeitet wurde. Dieser Cacheeintragstyp ist vom Auffangen ausgenommen.
NORMAL_CACHE_ENTRY
 Normaler Cacheeintrag, der gelöscht werden kann, um Speicherplatz für neue Einträge freizugeben.
SPARSE_CACHE_ENTRY
 Cacheeintrag für Teilantworten.
STICKY_CACHE_ENTRY
 Cacheeintrag für Kurznotizen, von der Löschung ausgenommen.
TRACK_OFFLINE_CACHE_ENTRY
 Derzeit nicht implementiert.
TRACK_ONLINE_CACHE_ENTRY
 Derzeit nicht implementiert.
URLHISTORY_CACHE_ENTRY
 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 WinINet unterstützt keine Serverimplementierungen. Darüber hinaus sollte es nicht von einem Dienst aus verwendet werden. Verwenden Sie für Serverimplementierungen oder Dienste Microsoft Windows HTTP Services (WinHTTP).
 

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

Anforderung Wert
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

Weitere Informationen

Zwischenspeichern

WinINet-Funktionen