OnPostEnumerateKey event/delegate/callback


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

CBFSRegistry     See also    


This callback is called after the iteration of the key enumeration request has been processed by the system code which deals with the registry.


    property OnPostEnumerateKey : TCbRegPostEnumerateKeyEvent;
    TCbRegPostEnumerateKeyEvent = procedure( Sender : TObject; UserContext: pointer; Result: LongWord; Index: LongWord; KeyInformationClass: KEY_INFORMATION_CLASS; KeyInformation: TCbRegInformation; var StopFiltering : boolean ) of object;

[C++ (Lib)]
    typedef void (*CbRegPostEnumerateKeyEvent)( CBFSRegistry* Sender, LPVOID UserContext, DWORD Result, DWORD Index, KEY_INFORMATION_CLASS KeyInformationClass, CbRegInformation *KeyInformation, BOOL * StopFiltering );

[C++ (VCL)]
    typedef void __fastcall (__closure *TCbRegPostEnumerateKeyEvent)( System::TObject* Sender, void *UserContext, unsigned Result, unsigned Index, Cbregapi::_KEY_INFORMATION_CLASS KeyInformationClass, TCbRegInformation *KeyInformation, bool &StopFiltering );

[C++ (.NET)]
    public delegate void CbRegPostEnumerateKeyEvent( CBFSRegistry^ Sender, Object^ UserContext, UInt32 Result, UInt32 Index, CbReg::KEY_INFORMATION_CLASS KeyInformationClass, CbRegInformation^ KeyInformation, bool %StopFiltering );

    delegate void CbRegPostEnumerateKeyEvent( CBFSRegistry Sender, Object UserContext, UInt32 Result, UInt32 Index, CbReg.KEY_INFORMATION_CLASS KeyInformationClass, CbRegInformation KeyInformation, ref bool StopFiltering );

    Delegate Sub CbRegPostEnumerateKeyEvent( ByVal Sender As CBFSRegistry, ByVal UserContext As Object, ByVal Result As UInt32, ByVal Index As UInt32, ByVal KeyInformationClass As CbReg.KEY_INFORMATION_CLASS, ByVal KeyInformation As CbRegInformation, ByRef StopFiltering As Boolean )


  • Sender - reference to the class that called the delegate/event handler
  • UserContext - the placeholder for the application-defined data
  • Result - win32 error value of the operation. This value is returned to the originator of the request in the case no other result is returned from the callback.
  • Index - the zero-based index of the subkey within the key
  • KeyInformationClass - the value that indicates the type of information to be returned by the system in the KeyInformation object
  • KeyInformation - the object that contains information being returned to the system
  • StopFiltering - if StopFiltering is set to true, no other callbacks for the created key handle will be called

Values of KeyInformationClass


This callback/event is called after each iteration of the key enumeration request is processed by the registry manager in Windows. The name of the key should be obtained from the user context which must have been set in OnPreOpenKey/OnPreOpenKey callback/event handlers.
Read more about contexts.

Error handling

See Error handling topic for detailed information about how to report errors, which occur in the event handlers, back to CBFSRegistry.

See also

OnPreCreateKey     OnPreEnumerateKey     OnPreOpenKey