CallbackRegistry

Control registry operations in Windows and .NET applications

OnPostQueryValueKey event/delegate/callback

Filter:

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

CallbackRegistry     See also    

Overview

This callback is called after the request for key value data has been processed by the system code which deals with the registry.

Declaration

[Pascal]
    property OnPostQueryValueKey : TCbRegPostQueryValueKeyEvent;
    TCbRegPostQueryValueKeyEvent = procedure( Sender : TObject; UserContext: pointer; Result: LongWord; ValueName: TCBString; KeyValueInformationClass: KEY_VALUE_INFORMATION_CLASS; KeyValueInformation: TCbRegInformation; var StopFiltering : boolean ) of object;
    type TCBString = {$ifdef UNICODE}UnicodeString{$else}WideString{$endif};

[C++ (Lib)]
    typedef void (*CbRegPostQueryValueKeyEvent)( CallbackRegistry* Sender, LPVOID UserContext, DWORD Result, PCWSTR ValueName, KEY_VALUE_INFORMATION_CLASS KeyValueInformationClass, CbRegInformation *KeyValueInformation, BOOL * StopFiltering );

[C++ (VCL)]
    typedef void __fastcall (__closure *TCbRegPostQueryValueKeyEvent)( System::TObject* Sender, void *UserContext, unsigned Result, TCBString ValueName, Cbregapi::_KEY_VALUE_INFORMATION_CLASS KeyValueInformationClass, TCbRegInformation *KeyValueInformation, bool &StopFiltering );
    #ifdef UNICODE
    typedef UnicodeString TCBString;
    #else
    typedef WideString TCBString;
    #endif

[C++ (.NET)]
    public delegate void CbRegPostQueryValueKeyEvent( CallbackRegistry^ Sender, Object^ UserContext, UInt32 Result, String^ ValueName, CbReg::KEY_VALUE_INFORMATION_CLASS KeyValueInformationClass, CbRegInformation^ KeyValueInformation, bool %StopFiltering );

[C#]
    delegate void CbRegPostQueryValueKeyEvent( CallbackRegistry Sender, Object UserContext, UInt32 Result, String ValueName, CbReg.KEY_VALUE_INFORMATION_CLASS KeyValueInformationClass, CbRegInformation KeyValueInformation, ref bool StopFiltering );

[VB.NET]
    Delegate Sub CbRegPostQueryValueKeyEvent( ByVal Sender As CallbackRegistry, ByVal UserContext As Object, ByVal Result As UInt32, ByVal ValueName As String, ByVal KeyValueInformationClass As CbReg.KEY_VALUE_INFORMATION_CLASS, ByVal KeyValueInformation As CbRegInformation, ByRef StopFiltering As Boolean )

Parameters

  • 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.
  • ValueName - the name of the value being queried
  • KeyValueInformationClass - the value that indicates the type of information to be returned by the system in the KeyValueInformation object
  • KeyValueInformation - 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 KeyValueInformationClass

Description

This callback/event is called after the request for key value data 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 CallbackRegistry.

See also

OnPreCreateKey     OnPreOpenKey     OnPreQueryValueKey    

Back to top