on_close_named_streams_enumeration Event
Fires when the OS is finished enumerating a file's named streams.
Syntax
class CBFSCloseNamedStreamsEnumerationEventParams(object): @property def file_name() -> str: ... @property def handle_info() -> int: ... @property def file_context() -> int: ... @file_context.setter def file_context(value) -> None: ... @property def handle_context() -> int: ... @handle_context.setter def handle_context(value) -> None: ... @property def enumeration_context() -> int: ... @property def result_code() -> int: ... @result_code.setter def result_code(value) -> None: ... # In class CBFS: @property def on_close_named_streams_enumeration() -> Callable[[CBFSCloseNamedStreamsEnumerationEventParams], None]: ... @on_close_named_streams_enumeration.setter def on_close_named_streams_enumeration(event_hook: Callable[[CBFSCloseNamedStreamsEnumerationEventParams], None]) -> None: ...
Remarks
This event fires when the OS is finished enumerating the named streams of the file specified by FileName.
This event only needs to be handled if the use_alternate_data_streams property is enabled. To handle this event properly, applications must release any resources that were allocated for/by the named stream enumeration in earlier on_enumerate_named_streams events.
The HandleInfo parameter carries a handle to an object with information about the file handle. While within the event handler, it can be used to call any of the following methods: get_handle_creator_process_id, get_handle_creator_process_name, get_handle_creator_thread_id, or get_handle_creator_token.
The FileContext, HandleContext, and EnumerationContext parameters are placeholders for application-defined data associated with the file, specific handle, and enumeration; respectively. Please refer to the Contexts topic for more information.
The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason (e.g., a resource isn't available, security checks failed, etc.), set it to a non-zero value to report an appropriate error. Please refer to the Error Reporting and Handling topic for more information.