ReadDir Event

Fires when the OS wants to read (enumerate) a directory's contents.

Syntax

• C++

ANSI (Cross Platform)
virtual int FireReadDir(FUSEReadDirEventParams *e);

typedef struct {
  const char *Path;
  int64 FillerContext;
  int Result;
  int reserved;
} FUSEReadDirEventParams;

Unicode (Windows)
virtual INT FireReadDir(FUSEReadDirEventParams *e);

typedef struct {
  LPCWSTR Path;
  LONG64 FillerContext;
  INT Result;
  INT reserved;
} FUSEReadDirEventParams;

#define EID_FUSE_READDIR 17

virtual INT CBFSFUSE_CALL FireReadDir(LPWSTR &lpszPath, LONG64 &lFillerContext, INT &iResult);

Remarks

This event fires when the OS wants to enumerate the contents of the directory, identified by Path. In response to this event the application must call the Filler method and pass it FillerContextparameter as well as the information about the directory entry. Please, refer to the description of Filler for further details.

If Filler returns an error code, set Result to the returned code (do not negate the code). If there are no more files to pass, set Result to 0.

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.