OpenHandlesCount Property

The number of handles to filesystem objects in the virtual drive that are currently open.

Syntax

property OpenHandlesCount: Integer read get_OpenHandlesCount;

Default Value

0

Remarks

This property reflects the number of handles to filesystem objects (files, directories, etc.) in the virtual drive that are currently open. It is populated when CreateOpenedFilesSnapshot is called, and cleared when CloseOpenedFilesSnapshot is called; please refer to those methods for more information.

This property's value may differ from that of the OpenObjectsCount property, and from the number of items in the OpenFile* properties. This occurs because each object can be opened several times, and because the OS may keep files open even after all handles to them have been closed.

Note: The methods and properties related to open files snapshots are not intended to be used from multiple threads at once. Applications that wish to use said methods and properties from multiple threads are responsible for employing proper thread synchronization techniques to ensure that creation, use, and cleanup of open files snapshots occurs in a thread-safe manner.

This property is read-only and not available at design time.