PolReportLastHandleClosed callback function

A Policy DLL's PolReportLastHandleClosed callback function is called to inform the Policy DLL that the last handle to a given file has been closed.

Syntax

POL_REPORT_LAST_HANDLE_CLOSED PolReportLastHandleClosed;

VOID

PolReportLastHandleClosed(

    _In_  PVOID CleanupInfo

)

Parameters

CleanupInfo [in]

A Policy DLL defined value that was supplied to either PolGetKeyNewFile or PolGetKeyFromHeader.  This value can be used to identify the file being closed.

Return value

(none)

Remarks

A Policy DLL's PolReportLastHandleClosed callback function is called by FESF to inform the Policy DLL that the last handle has been closed.  This callback allows the Policy DLL to trigger additional processing of the file.  Since the last handle has been closed, a Solution that attempts to open the file in the context of this callback will usually succeed without encountering a sharing violation.  Note, however, that subsequent opens before the callback is called make sharing violation still possible, just unlikely.  Hence your Solution may need to be constructed to gracefully handle this possibility, for instance, by queuing the work to be done later.

Implementation of this callback function is optional for a Policy DLL, and it is rarely specified.  If this function is not implemented, FESF does not notify the Policy DLL of the last close that takes place for a given file.

Examples

See Also

Requirements