INTERNET_CACHE_ENTRY_INFOW-Struktur (wininet.h)

Artikel
03/04/2024

Enthält Informationen zu einem Eintrag im Internetcache.

Syntax

typedef struct _INTERNET_CACHE_ENTRY_INFOW {
  DWORD    dwStructSize;
  LPWSTR   lpszSourceUrlName;
  LPWSTR   lpszLocalFileName;
  DWORD    CacheEntryType;
  DWORD    dwUseCount;
  DWORD    dwHitRate;
  DWORD    dwSizeLow;
  DWORD    dwSizeHigh;
  FILETIME LastModifiedTime;
  FILETIME ExpireTime;
  FILETIME LastAccessTime;
  FILETIME LastSyncTime;
  LPWSTR   lpHeaderInfo;
  DWORD    dwHeaderInfoSize;
  LPWSTR   lpszFileExtension;
  union {
    DWORD dwReserved;
    DWORD dwExemptDelta;
  };
} INTERNET_CACHE_ENTRY_INFOW, *LPINTERNET_CACHE_ENTRY_INFOW;

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-Zeichenfolge, die den URL-Namen enthält. Die Zeichenfolge belegt den Speicherbereich am Ende dieser Struktur.

lpszLocalFileName

Zeiger auf eine NULL-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 mindestens null 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 Auffangen ausgenommen.
SPARSE_CACHE_ENTRY	Cacheeintrag für Teilantworten.
STICKY_CACHE_ENTRY	Sticky Cache-Eintrag, der für den von dwExemptDelta angegebenen Zeitraum vom Auffangen ausgenommen ist. Der Von CommitUrlCacheEntryA und CommitUrlCacheEntryW festgelegte Standardwert beträgt einen 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

Hochgeordneter 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 die Uhrzeit des letzten Zugriffs im Greenwich-Mittelzeitformat enthält.

LastSyncTime

FILETIME-Struktur , die den Zeitpunkt enthält, zu dem der Cache zuletzt synchronisiert wurde.

lpHeaderInfo

Zeiger auf einen Puffer, der die Headerinformationen enthält. Der Puffer belegt den Arbeitsspeicher 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 Begrenzung der Cacheeintragsgröße, sodass Anwendungen, die den Cache aufzählen müssen, für die Zuweisung von Puffern mit variabler Größe vorbereitet sein 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 aus 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 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]
Kopfzeile	wininet.h