Freigeben über

FindFirstUrlCacheEntryExA-Funktion (wininet.h)

  • Artikel

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 zu suchde Quellnamenmuster enthält. Dieser Parameter kann nur auf "cookie:", "visited:" oder NULL festgelegt werden. Legen Sie diesen Parameter auf "cookie:" fest, um die Cookies aufzählen oder "visited:" aufzählen, um die URL-Verlaufseinträge im Cache aufzählen zu können. Wenn dieser Parameter NULL ist, gibt FindFirstUrlCacheEntryEx alle Inhaltseinträge im Cache zurück.

[in] dwFlags

Steuert die Aufzählung. Derzeit werden keine Kennzeichnungen implementiert; Dieser Parameter muss auf Null festgelegt werden.

[in] dwFilter

Eine Bitmaske, die den Typ des Cacheeintrags und deren 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 null oder mehr der folgenden Eigenschaftskennzeichnungen und Cachetypkennzeichnungen sein, die unten aufgeführt sind.

Wert Bedeutung
COOKIE_CACHE_ENTRY
 Cookie-Cacheeintrag.
EDITED_CACHE_ENTRY
 Cacheeintragsdatei, die extern bearbeitet wurde. Dieser Cacheeintragstyp ist vom Gerüst ausgenommen.
NORMAL_CACHE_ENTRY
 Normaler Cacheeintrag; kann gelöscht werden, um Speicherplatz für neue Einträge wiederherzustellen.
SPARSE_CACHE_ENTRY
 Partieller Antwortcacheeintrag.
STICKY_CACHE_ENTRY
 Sticky cache entry; ausgenommen von Gerüsten.
TRACK_OFFLINE_CACHE_ENTRY
 Derzeit nicht implementiert.
TRACK_ONLINE_CACHE_ENTRY
 Derzeit nicht implementiert.
URLHISTORY_CACHE_ENTRY
 Besuchter Linkcacheeintrag.

[in] GroupId

ID der Cachegruppe, die aufgezählt werden soll. Legen Sie diesen Parameter auf Null fest, um alle Einträge auflisten, die nicht gruppiert sind.

[out] lpFirstCacheEntryInfo

Zeigen Sie auf eine INTERNET_CACHE_ENTRY_INFO Struktur, um die Cacheeintragsinformationen zu erhalten.

[in, out] lpcbCacheEntryInfo

Zeiger auf Variable, der die Größe der Struktur angibt, auf die von der lpFirstCacheEntryInfo Parameter in Bytes verwiesen wird.

[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 ein gültiges Handle zurück, wenn dies erfolgreich ist, oder NULL auf andere Weise. Rufen Sie zum Abrufen bestimmter Fehlerinformationen GetLastError-auf. Wenn die Funktion keine übereinstimmenden Dateien findet, gibt GetLastError- ERROR_NO_MORE_FILES zurück.

Bemerkungen

Das von FindFirstUrlCacheEntryEx zurückgegebene Handle wird in allen nachfolgenden Aufrufen von FindNextUrlCacheEntryExverwendet. Am Ende der Enumeration sollte die Anwendung FindCloseUrlCacheaufrufen.

Wie alle anderen Aspekte der WinINet-API kann diese Funktion nicht innerhalb von DllMain oder den Konstruktoren und Destruktoren globaler Objekte sicher aufgerufen werden.

Hinweis WinINet keine Serverimplementierungen unterstützt. Darüber hinaus sollte sie nicht von einem Dienst verwendet werden. Verwenden Sie für Serverimplementierungen oder -dienste Microsoft Windows HTTP Services (WinHTTP).
 

Anmerkung

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 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
mindestens unterstützte Client- Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server- Windows 2000 Server [nur Desktop-Apps]
Zielplattform- Fenster
Header- wininet.h
Library Wininet.lib
DLL- Wininet.dll

Siehe auch

Zwischenspeichern

WinINet-Funktionen