InternetLockRequestFile-Funktion (wininet.h)

Artikel
08/27/2023

Platziert eine Sperre für die verwendete Datei.

Syntax

BOOL InternetLockRequestFile(
  [in]  HINTERNET hInternet,
  [out] HANDLE    *lphLockRequestInfo
);

Parameter

[in] hInternet

Von der Funktion FtpOpenFile, GopherOpenFile, HttpOpenRequest oder InternetOpenUrl zurückgegebenes Handle.

[out] lphLockRequestInfo

Zeiger auf ein Handle, das das Sperranforderungshandle empfängt.

Rückgabewert

Gibt TRUE zurück, wenn erfolgreich, andernfalls FALSE . Rufen Sie GetLastError auf, um eine bestimmte Fehlermeldung zu erhalten.

Hinweise

Wenn das an hInternet übergebene HINTERNET-Handle mit INTERNET_FLAG_NO_CACHE_WRITE oder INTERNET_FLAG_DONT_CACHE erstellt wurde, erstellt die Funktion eine temporäre Datei mit der Erweiterung TMP, es sei denn, es handelt sich um eine HTTPS-Ressource. Wenn das Handle mit INTERNET_FLAG_NO_CACHE_WRITE oder INTERNET_FLAG_DONT_CACHE erstellt wurde und auf eine HTTPS-Ressource zugreift, schlägt InternetLockRequestFile fehl.

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


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

Aktivieren von Internetfunktionen

InternetUnlockRequestFile

WinINet-Funktionen

Freigeben über