Share via

GetUrlCacheEntryInfoExA-Funktion (wininet.h)

  • Artikel

Ruft Informationen zum Cacheeintrag ab, der der angegebenen URL zugeordnet ist, wobei alle Umleitungen berücksichtigt werden, die im Offlinemodus von der HttpSendRequest-Funktion angewendet werden.

Syntax

BOOL GetUrlCacheEntryInfoExA(
  [in]                LPCSTR                       lpszUrl,
  [in, out, optional] LPINTERNET_CACHE_ENTRY_INFOA lpCacheEntryInfo,
  [in, out, optional] LPDWORD                      lpcbCacheEntryInfo,
  [out]               LPSTR                        lpszRedirectUrl,
  [in, out]           LPDWORD                      lpcbRedirectUrl,
                      LPVOID                       lpReserved,
  [in]                DWORD                        dwFlags
);

Parameter

[in] lpszUrl

Ein Zeiger auf eine NULL-endende 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 zugeordnet werden.

Da die erforderliche Größe des Puffers im Voraus nicht bekannt ist, ist es am besten, 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 Cacheeinträge, sodass Anwendungen, die den Cache auflisten müssen, für die Zuweisung von Puffern mit variabler Größe vorbereitet werden müssen.

[in, out, optional] lpcbCacheEntryInfo

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.

[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 die URL gefunden wurde, oder andernfalls FALSE . Rufen Sie GetLastError für bestimmte Fehlerinformationen auf. Mögliche Fehler sind:

Rückgabecode Beschreibung
ERROR_FILE_NOT_FOUND
 Die URL wurde nicht im Cacheindex gefunden, auch nachdem zwischengespeicherte Umleitungen berücksichtigt wurden.
ERROR_INSUFFICIENT_BUFFER
 Der Puffer, auf den von lpCacheEntryInfo verwiesen wird, war nicht groß genug, um die angeforderten Informationen zu enthalten. Die größe des erforderlichen Puffers wird an lpdwCacheEntryInfoBufSize zurückgegeben.

Hinweise

GetUrlCacheEntryInfoEx führt keine URL-Analyse durch, sodass eine URL, die einen Anker (#) enthält, nicht im Cache gefunden wird, auch wenn die Ressource zwischengespeichert ist. 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 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 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
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