INTERNET_CACHE_ENTRY_INFOA Struktur (wininet.h)

Artikel
11/20/2024

Enthält Informationen zu einem Eintrag im Internetcache.

Syntax

typedef struct _INTERNET_CACHE_ENTRY_INFOA {
  DWORD    dwStructSize;
  LPSTR    lpszSourceUrlName;
  LPSTR    lpszLocalFileName;
  DWORD    CacheEntryType;
  DWORD    dwUseCount;
  DWORD    dwHitRate;
  DWORD    dwSizeLow;
  DWORD    dwSizeHigh;
  FILETIME LastModifiedTime;
  FILETIME ExpireTime;
  FILETIME LastAccessTime;
  FILETIME LastSyncTime;
  LPSTR    lpHeaderInfo;
  DWORD    dwHeaderInfoSize;
  LPSTR    lpszFileExtension;
  union {
    DWORD dwReserved;
    DWORD dwExemptDelta;
  };
} INTERNET_CACHE_ENTRY_INFOA, *LPINTERNET_CACHE_ENTRY_INFOA;

Angehörige

dwStructSize

Größe dieser Struktur in Byte. Dieser Wert kann verwendet werden, um die Version des Cachesystems zu ermitteln.

lpszSourceUrlName

Zeigen Sie auf eine mit Null beendete Zeichenfolge, die den URL-Namen enthält. Die Zeichenfolge belegt den Speicherbereich am Ende dieser Struktur.

lpszLocalFileName

Zeigen Sie auf eine mit Null beendete Zeichenfolge, die den lokalen Dateinamen enthält. Die Zeichenfolge belegt den Speicherbereich am Ende dieser Struktur.

CacheEntryType

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).

Dieses Element kann null oder mehr der folgenden Eigenschaftskennzeichnungen und Cachetypkennzeichnungen sein, die unten aufgeführt sind.

Wert	Bedeutung
EDITED_CACHE_ENTRY	Cacheeintragsdatei, die extern bearbeitet wurde. Dieser Cacheeintragstyp ist vom Gerüst ausgenommen.
SPARSE_CACHE_ENTRY	Partieller Antwortcacheeintrag.
STICKY_CACHE_ENTRY	Sticky cache entry that is exempt from scavenging for the amount of time specified by dwExemptDelta. Der von CommitUrlCacheEntryA und CommitUrlCacheEntryW- festgelegte Standardwert ist ein Tag.
TRACK_OFFLINE_CACHE_ENTRY	Derzeit nicht implementiert.
TRACK_ONLINE_CACHE_ENTRY	Derzeit nicht implementiert.

Die folgende Liste enthält die Cachetypkennzeichnungen.

Wert	Bedeutung
COOKIE_CACHE_ENTRY	Cookie-Cacheeintrag.
NORMAL_CACHE_ENTRY	Normaler Cacheeintrag; kann gelöscht werden, um Speicherplatz für neue Einträge wiederherzustellen.
URLHISTORY_CACHE_ENTRY	Besuchter Linkcacheeintrag.

dwUseCount

Aktuelle Anzahl der WinINEet-Aufrufer mithilfe des Cacheeintrags.

dwHitRate

Anzahl der Abrufe des Cacheeintrags.

dwSizeLow

Geringer Teil der Dateigröße in Byte.

dwSizeHigh

Hoher Teil der Dateigröße in Byte.

LastModifiedTime

FILETIME- Struktur, die den Zeitpunkt der letzten Änderung dieser URL enthält, im Greenwich-Mittelzeitformat.

ExpireTime

FILETIME- Struktur, die die Ablaufzeit dieser Datei enthält, im Greenwich-Mittelzeitformat.

LastAccessTime

FILETIME- Struktur, die die letzte Zugriffszeit enthält, im Greenwich-Mittelzeitformat.

LastSyncTime

FILETIME- Struktur, die das letzte Mal enthält, als der Cache synchronisiert wurde.

lpHeaderInfo

Zeigen Sie auf einen Puffer, der die Kopfzeileninformationen enthält. Der Puffer belegt den Speicher am Ende dieser Struktur.

dwHeaderInfoSize

Größe des lpHeaderInfo- Puffers in TCHARs.

lpszFileExtension

Zeigen Sie auf eine Zeichenfolge, die die Dateinamenerweiterung enthält, die zum Abrufen der Daten als Datei verwendet wird. Die Zeichenfolge belegt den Speicherbereich am Ende dieser Struktur.

dwReserved

dwExemptDelta

Ausnahmezeit vom letzten Zugriffszeitpunkt in Sekunden.

Bemerkungen

Es gibt keine Größenbeschränkung für den Cacheeintrag, sodass Anwendungen, die den Cache aufzählen müssen, vorbereitet sein müssen, um Puffer mit variabler Größe zuzuweisen. Weitere Informationen finden Sie unter Verwenden von Puffern.

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 INTERNET_CACHE_ENTRY_INFO 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]
Header-	wininet.h