UnlockUrlCacheEntryFileW-Funktion (wininet.h)

Artikel
11/20/2024

Entsperrt den Cacheeintrag, der gesperrt wurde, während die Datei aus dem Cache abgerufen wurde.

Syntax

BOOL UnlockUrlCacheEntryFileW(
  [in] LPCWSTR lpszUrlName,
  [in] DWORD   dwReserved
);

Parameter

[in] lpszUrlName

Zeigen Sie auf eine NULL--terminated-Zeichenfolge, die den Quellnamen des Cacheeintrags angibt, der entsperrt wird. Die Namenszeichenfolge darf keine Escapezeichen enthalten.

[in] dwReserved

Dieser Parameter ist reserviert und muss 0 sein.

Rückgabewert

Gibt TRUE zurück, wenn dies erfolgreich ist, oder FALSE andernfalls. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten. ERROR_FILE_NOT_FOUND gibt an, dass der durch den Quellnamen angegebene Cacheeintrag im Cachespeicher nicht gefunden wird.

Bemerkungen

Die Anwendung sollte nach dem Aufrufen dieser Funktion nicht auf die Datei zugreifen.

Wenn diese Funktion zurückgegeben wird, kann der Cache-Manager den Cacheeintrag löschen.

Wie alle anderen Aspekte der WinINet-API kann diese Funktion nicht innerhalb von DllMain oder den Konstruktoren und Destruktoren globaler Objekte sicher aufgerufen werden.

Hinweis WinINet keine Serverimplementierungen unterstützt. Darüber hinaus sollte sie nicht von einem Dienst verwendet werden. Verwenden Sie für Serverimplementierungen oder -dienste Microsoft Windows HTTP Services (WinHTTP).

Anmerkung

Der wininet.h-Header definiert UnlockUrlCacheEntryFile 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

Siehe auch

Zwischenspeichern

WinINet-Funktionen

Freigeben über