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 |
|---|---|
|
Cacheeintrag für Cookies. |
|
Cacheeintragsdatei, die extern bearbeitet wurde. Dieser Cacheeintragstyp ist vom Abfangen ausgenommen. |
|
Normaler Cacheeintrag, der gelöscht werden kann, um Speicherplatz für neue Einträge freizugeben. |
|
Cacheeintrag für Teilantworten. |
|
Cacheeintrag für Kurznotizen, von der Löschung ausgenommen. |
|
Derzeit nicht implementiert. |
|
Derzeit nicht implementiert. |
|
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 |
|---|---|
|
Der Cachespeicher ist voll. |
|
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
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 |