FindFirstUrlCacheEntryW-Funktion (wininet.h)
Beginnt die Aufzählung des Internetcaches.
Syntax
HANDLE FindFirstUrlCacheEntryW(
[in] LPCWSTR lpszUrlSearchPattern,
[out] LPINTERNET_CACHE_ENTRY_INFOW lpFirstCacheEntryInfo,
[in, out] LPDWORD lpcbCacheEntryInfo
);
Parameter
[in] lpszUrlSearchPattern
Ein Zeiger auf eine Zeichenfolge, die das Quellnamenmuster enthält, nach dem gesucht werden soll. Dieser Parameter kann nur auf "cookie:", "visited:" oder NULL festgelegt werden. Legen Sie diesen Parameter auf "cookie:" fest, um die Cookies oder "besucht:" aufzählen, um die URL-Verlaufseinträge im Cache aufzählen zu können. Wenn dieser Parameter NULL ist, gibt FindFirstUrlCacheEntry alle Inhaltseinträge im Cache zurück.
[out] lpFirstCacheEntryInfo
Zeiger auf eine INTERNET_CACHE_ENTRY_INFO Struktur.
[in, out] lpcbCacheEntryInfo
Zeiger auf eine Variable, die die Größe des lpFirstCacheEntryInfo-Puffers in Bytes angibt. Wenn die Funktion zurückgibt, enthält die Variable die Anzahl von Bytes, die in den Puffer kopiert wurden, oder die erforderliche Größe, die zum Abrufen des Cacheeintrags in Bytes erforderlich ist.
Rückgabewert
Gibt einen Handle zurück, den die Anwendung in der Funktion "FindNextUrlCacheEntry " verwenden kann, um nachfolgende Einträge im Cache abzurufen. Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
ERROR_INSUFFICIENT_BUFFER gibt an, dass die Größe von lpFirstCacheEntryInfo wie von lpdwFirstCacheEntryInfoBufferSize nicht ausreichend ist, um alle Informationen zu enthalten. Der in lpdwFirstCacheEntryInfoBufferSize zurückgegebene Wert gibt die für alle Informationen erforderliche Puffergröße an.
Bemerkungen
Der von FindFirstUrlCacheEntry zurückgegebene Handle wird in allen nachfolgenden Aufrufen von FindNextUrlCacheEntry verwendet. Am Ende der Aufzählung sollte die Anwendung FindCloseUrlCache aufrufen.
FindFirstUrlCacheEntry und FindNextUrlCacheEntry geben Variablengrößeninformationen zurück. Wenn ERROR_INSUFFICIENT_BUFFER zurückgegeben wird, sollte die Anwendung einen Puffer der größe zuweisen, die von lpdwFirstCacheEntryInfoBufferSize angegeben ist. Weitere Informationen finden Sie unter Verwenden von Puffern.
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 FindFirstUrlCacheEntry als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstanten automatisch auswählt. Das Mischen der Verwendung des Codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann dazu führen, dass keine Übereinstimmungen auftreten, 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 |