GetUrlCacheEntryInfoExW-Funktion (wininet.h)
Ruft Informationen zum Cacheeintrag ab, der der angegebenen URL zugeordnet ist, wobei alle Umleitungen berücksichtigt werden, die vom HttpSendRequest-Funktion im Offlinemodus angewendet werden.
Syntax
BOOL GetUrlCacheEntryInfoExW(
[in] LPCWSTR lpszUrl,
[in, out, optional] LPINTERNET_CACHE_ENTRY_INFOW lpCacheEntryInfo,
[in, out, optional] LPDWORD lpcbCacheEntryInfo,
[out] LPWSTR lpszRedirectUrl,
[in, out] LPDWORD lpcbRedirectUrl,
LPVOID lpReserved,
[in] DWORD dwFlags
);
Parameter
[in] lpszUrl
Ein Zeiger auf eine NULL--terminated-Zeichenfolge, die den Namen des Cacheeintrags enthält. Die Namenszeichenfolge darf keine Escapezeichen enthalten.
[in, out, optional] 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 im Voraus nicht bekannt ist, empfiehlt es sich, einen Puffer zuzuweisen, der für die Verarbeitung der Größe der meisten INTERNET_CACHE_ENTRY_INFO Einträge geeignet ist. Es gibt keine Größenbeschränkung für den Cacheeintrag, sodass Anwendungen, die den Cache aufzählen müssen, vorbereitet sein müssen, um Puffer mit variabler Größe zuzuweisen.
[in, out, optional] lpcbCacheEntryInfo
Zeiger auf eine Variable, die die Größe des lpCacheEntryInfo- Puffers in Byte angibt. Wenn die Funktion zurückgegeben wird, enthält die Variable die Anzahl der in den Puffer kopierten Bytes oder die erforderliche Größe des Puffers in Byte.
[out] lpszRedirectUrl
Dieser Parameter ist reserviert und muss NULL-sein.
[in, out] lpcbRedirectUrl
Dieser Parameter ist reserviert und muss NULL-sein.
lpReserved
Dieser Parameter ist reserviert und muss NULL-sein.
[in] dwFlags
Dieser Parameter ist reserviert und muss 0 sein.
Rückgabewert
Gibt TRUE zurück, wenn sich die URL befindet, oder FALSE andernfalls. Rufen Sie GetLastError- für bestimmte Fehlerinformationen auf. Mögliche Fehler sind:
| Rückgabecode | Beschreibung |
|---|---|
|
Die URL wurde im Cacheindex nicht gefunden, auch nachdem alle zwischengespeicherten Umleitungen berücksichtigt wurden. |
|
Der Puffer, auf den lpCacheEntryInfo verweist, war nicht groß genug, um die angeforderten Informationen aufzunehmen. Die größe des erforderlichen Puffers wird an lpdwCacheEntryInfoBufSizezurückgegeben. |
Bemerkungen
GetUrlCacheEntryInfoEx führt keine URL-Analyse durch, sodass eine URL mit einem Anker (#) nicht im Cache gefunden wird, auch wenn die Ressource zwischengespeichert wird. Wenn beispielsweise die URL http://example.com/example.htm#sample ü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 innerhalb von DllMain oder den Konstruktoren und Destruktoren globaler Objekte sicher aufgerufen werden.
Anmerkung
Der wininet.h-Header definiert GetUrlCacheEntryInfoEx 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 |
|---|---|
| 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 |