INTERNET_CACHE_ENTRY_INFOA-Struktur (wininet.h)

Artikel
08/27/2023

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;

Member

dwStructSize

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

lpszSourceUrlName

Zeiger auf eine NULL-endende Zeichenfolge, die den URL-Namen enthält. Die Zeichenfolge belegt den Speicherbereich am Ende dieser Struktur.

lpszLocalFileName

Zeiger auf eine NULL-endende 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 seine Eigenschaften angibt. Die Cacheeintragstypen umfassen: Verlaufseinträge (URLHISTORY_CACHE_ENTRY), Cookieeinträge (COOKIE_CACHE_ENTRY) und normale zwischengespeicherte Inhalte (NORMAL_CACHE_ENTRY).

Dieser Member kann null oder mehr der folgenden Eigenschaftsflags und Cachetypflags sein, die unten aufgeführt sind.

Wert	Bedeutung
EDITED_CACHE_ENTRY	Cacheeintragsdatei, die extern bearbeitet wurde. Dieser Cacheeintragstyp ist vom Abfangen ausgenommen.
SPARSE_CACHE_ENTRY	Cacheeintrag für Teilantworten.
STICKY_CACHE_ENTRY	Sticky Cache-Eintrag, der für den durch dwExemptDelta angegebenen Zeitraum vom Auffangen ausgenommen ist. Der Standardwert, der von CommitUrlCacheEntryA und CommitUrlCacheEntryW festgelegt wird, ist ein Tag.
TRACK_OFFLINE_CACHE_ENTRY	Derzeit nicht implementiert.
TRACK_ONLINE_CACHE_ENTRY	Derzeit nicht implementiert.

Die folgende Liste enthält die Cachetypflags.

Wert	Bedeutung
COOKIE_CACHE_ENTRY	Cacheeintrag für Cookies.
NORMAL_CACHE_ENTRY	Normaler Cacheeintrag, der gelöscht werden kann, um Speicherplatz für neue Einträge freizugeben.
URLHISTORY_CACHE_ENTRY	Cacheeintrag für besuchte Links.

dwUseCount

Aktuelle Anzahl von WinINEet-Aufrufern, die den Cacheeintrag verwenden.

dwHitRate

Anzahl der Abrufe des Cacheeintrags.

dwSizeLow

Niedriger Teil der Dateigröße in Bytes.

dwSizeHigh

Ein hoher Teil der Dateigröße in Bytes.

LastModifiedTime

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

ExpireTime

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

LastAccessTime

FILETIME-Struktur , die den Zeitpunkt des letzten Zugriffs im Greenwich-Mittelzeitformat enthält.

LastSyncTime

FILETIME-Struktur , die den Zeitpunkt der letzten Synchronisierung des Caches enthält.

lpHeaderInfo

Zeiger auf einen Puffer, der die Headerinformationen enthält. Der Puffer belegt den Speicher am Ende dieser Struktur.

dwHeaderInfoSize

Größe des lpHeaderInfo-Puffers in TCHARs.

lpszFileExtension

Zeiger 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 Zeitpunkt des letzten Zugriffs in Sekunden.

Hinweise

Es gibt keine Größenbeschränkung für Cacheeinträge, sodass Anwendungen, die den Cache auflisten müssen, für die Zuweisung von Puffern mit variabler Größe vorbereitet werden müssen. Weitere Informationen finden Sie unter Verwenden von Puffern.

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

Hinweis

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
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	wininet.h