Undocumented functions of NTDLL

2OO7, 27 April



NtCreateKeyedEvent
NtCreateKeyedEvent

NTSYSAPI 
NTSTATUS
NTAPI

NtCreateKeyedEvent(


  OUT PHANDLE             KeyedEventHandle,
  IN ACCESS_MASK          DesiredAccess,
  IN POBJECT_ATTRIBUTES   ObjectAttributes OPTIONAL,
  IN ULONG                Reserved );



Synchronization object called KeyedEvent is avaiable in Windows XP+ systems. It's usefull when both (or more) threads have to wait for each other.
  • KeyedEventHandle
    •     HANDLE to newly created KeyedEvent object.
  • DesiredAccess
    •     The same values as for Event objects (typically EVENT_ALL_ACCESS).
  • ObjectAttributes
    •     Optionally name of object.
  • Reserved
    •     Have to be zero. Reserved for future use.


    Supported on system versions:
    Win XP/2003



    Documented by:
    Tomasz Nowak



    Requirements:
    Library: ntdll.lib


    See also:
    NtOpenKeyedEvent
    NtReleaseKeyedEvent
    NtWaitForkeyedEvent