UseWindowsSecurity Property

Whether the virtual filesystem supports Windows' ACL-based security mechanisms.

Syntax

• C++

ANSI (Cross Platform)
int GetUseWindowsSecurity();
int SetUseWindowsSecurity(int bUseWindowsSecurity);

Unicode (Windows)
BOOL GetUseWindowsSecurity();
INT SetUseWindowsSecurity(BOOL bUseWindowsSecurity);

#define PID_CBFS_USEWINDOWSSECURITY 52

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 virtual filesystem should indicate to the system that it supports Windows' standard security mechanisms, which are based on ACLs (access control lists).

If this property is enabled, the application must properly handle the GetFileSecurity and SetFileSecurity events in order for Windows security mechanisms to function properly.

Note that Windows security attributes are an expected feature of the NTFS filesystem; if the application is identifying its virtual filesystem (via FileSystemName) as NTFS, supporting Windows security attributes is recommended.

Please refer to the Security Checks topic for more information.

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

Data Type

Boolean