FSDMGR_TestFileLock

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function authorizes read or write requests.

Syntax

BOOL
FSDMGR_TestFileLock(
    PACQUIREFILELOCKSTATE pAcquireFileLockState,
    PRELEASEFILELOCKSTATE pReleaseFileLockState,
    DWORD dwHandle,
    BOOL fRead,
    DWORD cbReadWrite
    );

Parameters

• pAcquireFileLockState
  Pointer to a PACQUIREFILELOCKSTATE function.

• pReleaseFileLockState
  Pointer to a PRELEASEFILELOCKSTATE function.

• dwHandle
  Handle to the specified file.

• fRead
  Specifies whether the file can be read.

• cbReadWrite
  Specifies whether the file can be read and written to.

Return Value

Nonzero indicates success. Zero indicates failure. To get extended error information, call GetLastError.

Remarks

The FSD can simply pass all parameters received by MyFSD_LockFileEx to this helper function, along with two helper function pointers, PACQUIREFILELOCKSTATE and PRELEASEFILELOCKSTATE, implemented by the FSD.

This function is a Lock Manager function provided by FSDMGR to assist FSDs with implementing the MyFSD_LockFileEx and the MyFSD_UnLockFileEx functions.

Requirements

See Also

Reference

FSDMGR Functions
FSDMGR_TestFileLockEx
FSDMGR_AcquireFileLock
FSDMGR_RemoveFileLock
FSDMGR_RemoveFileLockEx