FindFirstUrlCacheGroup-Funktion (wininet.h)

Artikel
08/27/2023

Initiiert die Enumeration der Cachegruppen im Internetcache.

Syntax

HANDLE FindFirstUrlCacheGroup(
  [in]      DWORD   dwFlags,
  [in]      DWORD   dwFilter,
  [in]      LPVOID  lpSearchCondition,
  [in]      DWORD   dwSearchCondition,
  [out]     GROUPID *lpGroupId,
  [in, out] LPVOID  lpReserved
);

Parameter

[in] dwFlags

Dieser Parameter ist reserviert und muss 0 sein.

[in] dwFilter

Zu verwendende Filter. Dieser Parameter kann null oder einer der folgenden Werte sein.

Wert	Bedeutung
CACHEGROUP_SEARCH_ALL	Durchsuchen Sie alle Cachegruppen.
CACHEGROUP_SEARCH_BYURL	Derzeit nicht implementiert.

[in] lpSearchCondition

Dieser Parameter ist reserviert und muss NULL sein.

[in] dwSearchCondition

Dieser Parameter ist reserviert und muss 0 sein.

[out] lpGroupId

Zeiger auf die ID der ersten Cachegruppe, die den Suchkriterien entspricht.

[in, out] lpReserved

Dieser Parameter ist reserviert und muss NULL sein.

Rückgabewert

Gibt bei erfolgreicher Ausführung ein gültiges Handle für das erste Element in der Enumeration zurück, andernfalls NULL . Rufen Sie GetLastError auf, um spezifische Fehlerinformationen zu erhalten. Wenn die Funktion keine übereinstimmenden Dateien findet, gibt GetLastError ERROR_NO_MORE_FILES zurück.

Hinweise

Das von FindFirstUrlCacheGroup zurückgegebene Handle wird in nachfolgenden Aufrufen von FindNextUrlCacheGroup verwendet. Am Ende der Enumeration sollte die Anwendung FindCloseUrlCache aufrufen.

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).

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