CallbackFilter.AddFilterAccessRuleEx method


Pascal    C++ (Lib)    C++ (VCL)    C++ (.NET)    C#    VB.NET   

CallbackFilter     See also    


This method adds a filter access rule with filtering by Extended Attribute name.


    function AddFilterAccessRuleEx(Mask : TCBString; EaName : AnsiString; AccessFlag : LongWord): boolean;
    type TCBString = {$ifdef UNICODE}UnicodeString{$else}WideString{$endif};

[C++ (Lib)]
    bool AddFilterAccessRuleEx(LPCWSTR Mask, LPCSTR EaName CbFltAccessFlags AccessFlag);

[C++ (VCL)]
    bool __fastcall AddFilterAccessRuleEx(WideString Mask, AnsiString EaName unsigned AccessFlag);

[C++ (.NET)]
    bool AddFilterAccessRuleEx(String^ Mask, String^ EaName, CbFltAccessFlags AccessFlag);

    bool AddFilterAccessRuleEx(String Mask, String EaName, CbFltAccessFlags AccessFlag);

    Function AddFilterAccessRuleEx(ByVal Mask As String, ByVal EaName As String, ByVal AccessFlag As CbFltAccessFlags) As Boolean


  • Mask - mask of the files to apply the filter to
  • EaName - name of the extended attribute. Wildcard characters are not allowed
  • AccessFlag - flags to be set on files that match the Mask

Return values

TRUE / true if the function succeeded or FALSE / false if the function failed.

AccessFlag values


Use this method to add a filter access rule with filtering by Extended Attribute name. Access rules allow to automatically process certain requests to the file system, without interference of the application.

For example, if AccessFlag is set to fltReadOnly, all files that match the Mask that have EaName attribute set, will be read-only for all applications.

Process-specific rules are supported.

Read more about masks.

See also

AddFilterCallbackRuleEx     DeleteFilterRule