on_set_default_quota_info Event

Fires when the OS needs to set the virtual drive's default quota information.

Syntax

class CBFSSetDefaultQuotaInfoEventParams(object):
  @property
  def default_quota_threshold() -> int: ...
  @property
  def default_quota_limit() -> int: ...
  @property
  def file_system_control_flags() -> int: ...
  @property
  def result_code() -> int: ...
  @result_code.setter
  def result_code(value) -> None: ...

# In class CBFS:
@property
def on_set_default_quota_info() -> Callable[[CBFSSetDefaultQuotaInfoEventParams], None]: ...
@on_set_default_quota_info.setter
def on_set_default_quota_info(event_hook: Callable[[CBFSSetDefaultQuotaInfoEventParams], None]) -> None: ...

Remarks

This event fires when the OS needs to set the virtual drive's default quota information.

This event only needs to be handled if the use_disk_quotas property is enabled. To handle this event properly, applications must store the virtual drive's default quota information using the value specified by DefaultQuotaThreshold, DefaultQuotaLimit, and FileSystemControlFlags.

Descriptions of the DefaultQuotaThreshold, DefaultQuotaLimit, and FileSystemControlFlags parameters can be found in the Windows API's FILE_FS_CONTROL_INFORMATION structure documentation.

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.