Instant control over file and folder operations in Windows and .NET applications

CallbackFilter.AddFilterCallbackRuleEx method


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

CallbackFilter     See also    


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


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

[C++ (Lib)]
    bool AddFilterCallbackRuleEx(LPCWSTR Mask, LPCSTR EaName, CbFltCallbackFlags CallbackFlag);

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

[C++ (.NET)]
    bool AddFilterCallbackRuleEx(String^ Mask, String^ EaName, CbFltCallbackFlags CallbackFlag);

    bool AddFilterCallbackRuleEx(String Mask, String EaName, CbFltCallbackFlags CallbackFlag);

    Function AddFilterCallbackRuleEx(ByVal Mask As String, ByVal EaName As String, ByVal CallbackFlag As CbFltCallbackFlags) As Boolean


  • Mask - mask of the files to apply the filter to
  • EaName - name of the extended attribute. Wildcard characters are not allowed
  • CallbackFlag - 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.

CallbackFlag values


Use this method to add a filter callback rule with filtering by Extended Attribute name. It means, that whenever some application (or the OS itself) tries to perform certain operations, specified by CallbackFlag, the corresponding callback will be called and it will notify your application about the event. If the callback function is not associated for the specific callback type, the request is processed as usually.

For example, if CallbackFlag is set to fltReadCallback, the OnReadFileC event will be fired if an application tries to read the file, whose name matches Mask.

Process-specific rules are supported.

Read more about masks.

See also

AddFilterAccessRuleEx     DeleteFilterRule    

Back to top