InternetLockRequestFile Function

---

Allows the user to place a lock on the file that is being used.

Syntax

BOOL InternetLockRequestFile(
    IN HINTERNET hInternet,
    OUT HANDLE *lphLockReqHandle
);

Parameters

hInternet

HINTERNET handle returned by FtpOpenFile, GopherOpenFile, HttpOpenRequest, or InternetOpenUrl.

lphLockReqHandle

Address of a handle to store the lock request handle.

Return Value

Returns TRUE if successful, or FALSE otherwise. To get a specific error message, call GetLastError.

Remarks

If the HINTERNET handle passed to hInternet was created using INTERNET_FLAG_NO_CACHE_WRITE or INTERNET_FLAG_DONT_CACHE, the function creates a temporary file with the extension .tmp, unless it is an HTTPS resource. If the handle was created using INTERNET_FLAG_NO_CACHE_WRITE or INTERNET_FLAG_DONT_CACHE and it is accessing an HTTPS resource, InternetLockRequestFile fails.

Function Information

Windows NT	Use version 4.0. Implemented only as an ANSI function.
Windows	Use Windows 95 and later. Implemented only as an ANSI function.
Header	Wininet.h
Import library	Wininet.lib
Minimum availability	Internet Explorer 3.0

Windows CE

Windows CE	Use version 2.12 and later
Minimum availability	Internet Explorer 4.0

See Also

Microsoft Win32 Internet Functions Overview, Enabling Internet Functionality, Microsoft Win32 Internet Functions Reference, General Win32 Internet Functions, InternetUnlockRequestFile