Create Event

Fires when the OS wants to create a file.

Syntax

• C#
• VB.NET

public event OnCreateHandler OnCreate;

public delegate void OnCreateHandler(object sender, FuseCreateEventArgs e);

public class FuseCreateEventArgs : EventArgs {
  public string Path { get; }
  public int Mode { get; }
  public int FileContext { get; set; }
  public int Result { get; set; }
}

Public Event OnCreate As OnCreateHandler

Public Delegate Sub OnCreateHandler(sender As Object, e As FuseCreateEventArgs)

Public Class FuseCreateEventArgs Inherits EventArgs
  Public ReadOnly Property Path As String
  Public ReadOnly Property Mode As Integer
  Public Property FileContext As Integer
  Public Property Result As Integer
End Class

Remarks

This event fires when the OS wants to create a file named Path. The application must create the file according to the creation mode and open it afterwards. The creation mode is specified in the Mode parameter, whose values correspond to the ones used in the creat() function in POSIX and Linux API.

The application may use the FileContext parameter to store a file handle or other information, related to the open file. Windows: the stored information will be shared between all concurrent file open operations performed on this file.

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 negative error code value (e.g. -ENOENT to indicate that the file does not exist) to report an appropriate error. Please refer to the Error Reporting and Handling topic for more information.