Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

Helper function provided by File System Disk Manager (FSDMGR) to simplify the implementation of the MyFSD_UnLockFileExfunction in a file system driver (FSD).

Syntax 

BOOL MyFSD_UnlockFileEx(
  PACQUIREFILELOCKSTATE 
pAcquireFileLockState
  PRELEASEFILELOCKSTATE 
pReleaseFileLockState
  DWORD 
dwHandle,
  DWORD 
dwReserved,
  DWORD 
nNumberOfBytesToUnlockLow,
  DWORD 
nNumberOfBytesToUnlockHigh,
  LPOVERLAPPED 
lpOverlapped
);

Parameters

pAcquireFileLockState

[in] Pointer to a PACQUIREFILELOCKSTATE in the calling FSD.

pReleaseFileLockState

[in] Pointer to a PRELEASEFILELOCKSTATE in the calling FSD.

pHandle

[in] Pointer to the value that an FSD passes to the FSDMGR_CreateFileHandlefunction when creating the file handle.

dwReserved

Ignored. Set to zero

nNumberOfBytesToUnlockLow

[in] Low-order portion of the length of the byte range to unlock.

nNumberOfBytesToUnlockHigh

[in] High-order portion of the length of the byte range to unlock.

lpOverlapped

[in] Pointer to an OVERLAPPEDstructure that is used with the unlock request. This structure contains the file offset of the beginning of the unlock range.

Return Value

Nonzero indicates that the lock was successfully removed. Zero indicates failure. To get extended error information, call GetLastError.

Remarks

The FSD can simply pass all parameters received by MyFSD_UnlockFileExto this helper function with two helper function pointers, PACQUIREFILELOCKSTATEand PRELEASEFILELOCKSTATE, implemented by the FSD.

This function is a Lock Manager function provided by FSDMGR to assist FSDs with implementing the MyFSD_LockFileExand the MyFSD_UnlockFileExfunctions.

Requirements

Header lockmgrhelp.h
Library Fsdmgr.lib
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also