create_opened_files_snapshot Method
Creates a snapshot of information about files that are currently open.
Syntax
def create_opened_files_snapshot() -> None: ...
Remarks
This method creates a snapshot of information about all files and directories in the virtual filesystem that are currently open. This information is then used to populate the OpenFile* properties, as well as the open_handles_count and open_objects_count properties.
Note that there will always be at least one item in the OpenFile* properties since the virtual volume itself is always inherently open.
When the application is finished working with the opened files snapshot, it must close it by calling the close_opened_files_snapshot method in order to release the associated memory. If this method is called again before an existing snapshot is closed, the class will attempt to close it before creating a new one.
Note: This method can only be called when active is True, and cannot be called within events.
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.