Freigeben über


CommitUrlCacheEntryW-Funktion (wininet.h)

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

Syntax

BOOL CommitUrlCacheEntryW(
  [in] LPCWSTR  lpszUrlName,
  [in] LPCWSTR  lpszLocalFileName,
  [in] FILETIME ExpireTime,
  [in] FILETIME LastModifiedTime,
  [in] DWORD    CacheEntryType,
  [in] LPWSTR   lpszHeaderInfo,
  [in] DWORD    cchHeaderInfo,
  [in] LPCWSTR  lpszFileExtension,
  [in] LPCWSTR  lpszOriginalUrl
);

Parameter

[in] lpszUrlName

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

[in] lpszLocalFileName

Zeiger auf eine Zeichenfolgenvariable, die den Namen der lokalen Datei enthält, die zwischengespeichert wird. Dies sollte derselbe Name sein, der von CreateUrlCacheEntryW zurückgegeben wird.

[in] ExpireTime

FILETIME-Struktur , die das Ablaufdatum und die Uhrzeit (in Greenwich Mean Time) der zwischengespeicherten Datei enthält. Wenn Datum und Uhrzeit des Ablaufs unbekannt sind, legen Sie diesen Parameter auf 0 (null) fest.

[in] LastModifiedTime

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

[in] 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 Parameter kann null oder mehr der folgenden Eigenschaftenflags und cachetypflags sein, die unten aufgeführt sind.

Wert Bedeutung
COOKIE_CACHE_ENTRY
Cacheeintrag für Cookies.
EDITED_CACHE_ENTRY
Cacheeintragsdatei, die extern bearbeitet wurde. Dieser Cacheeintragstyp ist vom Abfangen ausgenommen.
NORMAL_CACHE_ENTRY
Normaler Cacheeintrag, der gelöscht werden kann, um Speicherplatz für neue Einträge freizugeben.
SPARSE_CACHE_ENTRY
Cacheeintrag für Teilantworten.
STICKY_CACHE_ENTRY
Cacheeintrag für Kurznotizen, von der Löschung ausgenommen.
TRACK_OFFLINE_CACHE_ENTRY
Derzeit nicht implementiert.
TRACK_ONLINE_CACHE_ENTRY
Derzeit nicht implementiert.
URLHISTORY_CACHE_ENTRY
Cacheeintrag für besuchte Links.

[in] lpszHeaderInfo

Zeiger auf den Puffer, der die Headerinformationen 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 Headerinformationen in TCHARs. Wenn lpHeaderInfo nicht NULL ist, wird davon ausgegangen, dass dieser Wert die Größe des Puffers angibt, in dem die Headerinformationen gespeichert werden. Eine Anwendung kann Header als Teil der Daten verwalten und cchHeaderInfo zusammen mit einem NULL-Wert für lpHeaderInfo bereitstellen.

[in] lpszFileExtension

Dieser Parameter ist reserviert und muss NULL sein.

[in] lpszOriginalUrl

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

Rückgabewert

Gibt TRUE zurück, wenn erfolgreich, andernfalls FALSE . Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. Im Folgenden 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.

Hinweise

Der STICKY_CACHE_ENTRY Typ wird verwendet, um Cacheeinträge vom Abfangen ausgenommen zu machen. Die standardmäßige Ausnahmezeit für Einträge, die mit CommitUrlCacheEntryW festgelegt werden, beträgt zehn Minuten. Die Ausnahmezeit kann geändert werden, indem der parameter expires time in der INTERNET_CACHE_ENTRY_INFO-Struktur im Aufruf der SetUrlCacheEntryInfo-Funktion festgelegt wird.

Wenn der Cachespeicher voll ist, ruft CommitUrlCacheEntryW 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 entweder 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.

Beispielcode zum Aufrufen von CreateUrlCacheEntryW finden Sie unter Zwischenspeichern.

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

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 CommitUrlCacheEntry 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

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile wininet.h
Bibliothek Wininet.lib
DLL Wininet.dll

Weitere Informationen

Zwischenspeichern

WinINet-Funktionen