CommitUrlCacheEntryA-Funktion (wininet.h)

Artikel
11/20/2024

Speichert Daten in der angegebenen Datei im Internetcache und ordnet sie der angegebenen URL zu.

Syntax

BOOL CommitUrlCacheEntryA(
  [in] LPCSTR   lpszUrlName,
  [in] LPCSTR   lpszLocalFileName,
  [in] FILETIME ExpireTime,
  [in] FILETIME LastModifiedTime,
  [in] DWORD    CacheEntryType,
  [in] LPBYTE   lpHeaderInfo,
  [in] DWORD    cchHeaderInfo,
  [in] LPCSTR   lpszFileExtension,
  [in] LPCSTR   lpszOriginalUrl
);

Parameter

[in] lpszUrlName

Zeigen Sie auf eine Zeichenfolgenvariable, die den Quellnamen des Cacheeintrags enthält. Die Namenszeichenfolge muss eindeutig sein und darf keine Escapezeichen enthalten.

[in] lpszLocalFileName

Zeigen Sie auf eine Zeichenfolgenvariable, die den Namen der lokalen Datei enthält, die zwischengespeichert wird. Dies sollte derselbe Name wie die von CreateUrlCacheEntryAzurückgegeben werden.

[in] ExpireTime

FILETIME- Struktur, die das Ablaufdatum und die Ablaufzeit (in Greenwich mean time) der zwischengespeicherten Datei enthält. Wenn das Ablaufdatum und die Ablaufzeit unbekannt sind, legen Sie diesen Parameter auf Null fest.

[in] LastModifiedTime

FILETIME- Struktur, die das Datum und die Uhrzeit der letzten Änderung (in Greenwich mean time) der zwischengespeicherten URL enthält. Wenn das Datum und die Uhrzeit der letzten Änderung unbekannt sind, legen Sie diesen Parameter auf Null fest.

[in] 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).

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] lpHeaderInfo

Zeigen Sie auf den Puffer, der die Kopfzeileninformationen enthält. Wenn dieser Parameter nicht NULL-ist, werden die Headerinformationen als erweiterte Attribute der URL behandelt, die im lpHeaderInfo Member der INTERNET_CACHE_ENTRY_INFO Struktur zurückgegeben werden.

[in] cchHeaderInfo

Größe der Kopfzeileninformationen in TCHARs. Wenn lpHeaderInfo- nicht NULL-ist, wird dieser Wert angenommen, um die Größe des Puffers anzugeben, der die Headerinformationen speichert. Eine Anwendung kann Kopfzeilen als Teil der Daten verwalten und cchHeaderInfo- zusammen mit einem NULL- Wert für lpHeaderInfobereitstellen.

[in] lpszFileExtension

Dieser Parameter ist reserviert und muss NULL-sein.

[in] lpszOriginalUrl

Zeigen Sie auf eine Zeichenfolge, die die ursprüngliche URL enthält, wenn die Umleitung erfolgt ist.

Rückgabewert

Gibt TRUE zurück, wenn dies erfolgreich ist, oder FALSE andernfalls. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten. Nachfolgend sind mögliche Fehlerwerte aufgeführt.

Rückgabecode	Beschreibung
ERROR_DISK_FULL	Der Cachespeicher ist voll.
ERROR_FILE_NOT_FOUND	Die angegebene lokale Datei wurde nicht gefunden.

Bemerkungen

Der STICKY_CACHE_ENTRY Typ wird verwendet, um Cacheeinträge zu erstellen, die von der Gerüstierung ausgenommen sind. Die standardmäßige Ausnahmezeit für Einträge, die mithilfe von CommitUrlCacheEntryA- festgelegt werden, beträgt zehn Minuten. Die Ausnahmezeit kann geändert werden, indem sie den Ablaufzeitparameter in der INTERNET_CACHE_ENTRY_INFO Struktur im Aufruf der SetUrlCacheEntryInfo--Funktion festlegen.

Wenn der Cachespeicher voll ist, ruft CommitUrlCacheEntryA die Cachebereinigung auf, um Speicherplatz für diese neue Datei zu schaffen. Wenn der Cacheeintrag bereits vorhanden ist, überschreibt die Funktion den Eintrag, wenn er nicht verwendet wird. Ein Eintrag wird verwendet, wenn er mit RetrieveUrlCacheEntryStream- oder RetrieveUrlCacheEntryFile-abgerufen wurde.

Clients, die dem Cache Einträge hinzufügen, sollten die Header mindestens auf "HTTP/1.0 200 OK\r\n\r\n" festlegen; andernfalls sollten Microsoft Internet Explorer und andere Clientanwendungen den Eintrag ignorieren.

Siehe Caching beispielcode calling CreateUrlCacheEntryA.

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 CommitUrlCacheEntry als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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

Freigeben über