SerializeEvents Property

Whether events should be fired on a single worker thread, or many.

Syntax

• C++

ANSI (Cross Platform)
int GetSerializeEvents();
int SetSerializeEvents(int bSerializeEvents);

Unicode (Windows)
BOOL GetSerializeEvents();
INT SetSerializeEvents(BOOL bSerializeEvents);

#define PID_CBFS_SERIALIZEEVENTS 36

CBFSCONNECT_EXTERNAL void* CBFSCONNECT_CALL CBFSConnect_CBFS_Get(void *lpObj, int propid, int arridx, int *lpcbVal, int64 *lpllVal);
CBFSCONNECT_EXTERNAL int CBFSCONNECT_CALL CBFSConnect_CBFS_Set(void *lpObj, int propid, int arridx, const void *val, int cbVal);

Default Value

FALSE

Remarks

This property specifies whether the class should fire all events serially on a single worker thread, or concurrently on multiple worker threads. When this property is disabled (default), the MinWorkerThreadCount and MaxWorkerThreadCount configuration settings control how many worker threads are used to fire events.

Please note that, in general, the class will always fire events related to a single file sequentially (though not necessarily on the same worker thread), regardless of how this property is set. The one exception is that, if this property is disabled, the SerializeAccess property can be enabled to allow multiple read requests made against a single file to execute concurrently. Please refer to the Threading and Concurrency topic for more information.

Note: This property cannot be changed when Active is true, and cannot be changed within events.

Data Type

Boolean