SetUrlCacheEntryInfoA-Funktion (wininet.h)

Artikel
03/04/2024

Legt die angegebenen Member der INTERNET_CACHE_ENTRY_INFO-Struktur fest.

Syntax

BOOL SetUrlCacheEntryInfoA(
  [in] LPCSTR                       lpszUrlName,
  [in] LPINTERNET_CACHE_ENTRY_INFOA lpCacheEntryInfo,
  [in] DWORD                        dwFieldControl
);

Parameter

[in] lpszUrlName

Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des Cacheeintrags angibt. Die Namenszeichenfolge darf keine Escapezeichen enthalten.

[in] lpCacheEntryInfo

Zeiger auf eine INTERNET_CACHE_ENTRY_INFO-Struktur , die die Werte enthält, die dem durch lpszUrlName angegebenen Cacheeintrag zugewiesen werden sollen.

[in] dwFieldControl

Gibt die Member an, die festgelegt werden sollen. Für diesen Parameter ist eine Kombination der folgenden Werte gültig.

Wert	Bedeutung
CACHE_ENTRY_ACCTIME_FC	Legt den Zeitpunkt des letzten Zugriffs fest.
CACHE_ENTRY_ATTRIBUTE_FC	Legt den Cacheeintragstyp fest.
CACHE_ENTRY_EXEMPT_DELTA_FC	Legt das ausgenommene Delta fest.
CACHE_ENTRY_EXPTIME_FC	Legt die Ablaufzeit fest.
CACHE_ENTRY_HEADERINFO_FC	Derzeit nicht implementiert.
CACHE_ENTRY_HITRATE_FC	Legt die Trefferrate fest.
CACHE_ENTRY_MODTIME_FC	Legt den Zeitpunkt der letzten Änderung fest.
CACHE_ENTRY_SYNCTIME_FC	Legt den Zeitpunkt der letzten Synchronisierung fest.

Rückgabewert

Gibt TRUE zurück, wenn erfolgreich, andernfalls FALSE. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. Mögliche Fehlerwerte sind:

Rückgabecode	Beschreibung
ERROR_FILE_NOT_FOUND	Der angegebene Cacheeintrag wurde im Cache nicht gefunden.
ERROR_INVALID_PARAMETER	Die festzulegenden Werte sind ungültig.

Hinweise

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 SetUrlCacheEntryInfo 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]
Zielplattform	Windows
Kopfzeile	wininet.h
Bibliothek	Wininet.lib
DLL	Wininet.dll

Weitere Informationen

Zwischenspeichern

WinINet-Funktionen

Freigeben über