GetUrlCacheEntryInfoA-Funktion (wininet.h)
Ruft Informationen zu einem Cacheeintrag ab.
Syntax
BOOL GetUrlCacheEntryInfoA(
[in] LPCSTR lpszUrlName,
[out] LPINTERNET_CACHE_ENTRY_INFOA lpCacheEntryInfo,
[in, out] LPDWORD lpcbCacheEntryInfo
);
Parameter
[in] lpszUrlName
Ein Zeiger auf eine NULL-Zeichenfolge, die den Namen des Cacheeintrags enthält. Die Namenszeichenfolge sollte keine Escapezeichen enthalten.
[out] lpCacheEntryInfo
Ein Zeiger auf eine INTERNET_CACHE_ENTRY_INFO-Struktur , die Informationen zum Cacheeintrag empfängt. Für diesen Parameter sollte ein Puffer zugewiesen werden.
Da die erforderliche Größe des Puffers nicht im Voraus bekannt ist, ist es am besten, einen Puffer zuzuweisen, der für die Größe der meisten INTERNET_CACHE_ENTRY_INFO Einträge geeignet ist. 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.
[in, out] lpcbCacheEntryInfo
Ein Zeiger auf eine Variable, die die Größe des puffers lpCacheEntryInfo in Bytes angibt. Wenn die Funktion zurückgibt, enthält die Variable die Anzahl der in den Puffer kopierten Bytes oder die erforderliche Größe des Puffers in Bytes.
Rückgabewert
Gibt TRUE zurück, wenn der Vorgang erfolgreich war, oder andernfalls FALSE . Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. Mögliche Fehlerwerte sind:
| Rückgabecode | Beschreibung |
|---|---|
|
Der angegebene Cacheeintrag wird nicht im Cache gefunden. |
|
Die von lpdwCacheEntryInfo angegebene Größe von lpCacheEntryInfoBufferSize reicht nicht aus, um alle Informationen zu enthalten. Der in lpdwCacheEntryInfoBufferSize zurückgegebene Wert gibt die Puffergröße an, die erforderlich ist, um alle Informationen zu enthalten. |
Hinweise
GetUrlCacheEntryInfo führt keine URL-Analyse durch, sodass eine URL mit einem Anker (#) nicht im Cache gefunden wird, auch wenn die Ressource zwischengespeichert wird. Wenn die URL http://example.com/example.htm#sample beispielsweise übergeben wird, gibt die Funktion ERROR_FILE_NOT_FOUND zurück, auch wenn http://example.com/example.htm sich im Cache befindet.
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 GetUrlCacheEntryInfo 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
| 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 |