Syntax

  struct NotifyRegistrationDef 
  { 
      LONG   classobjectsignature; 
      BYTE   *name; 
      LONG   token; 
      LONG   notifytype; 
      LONG   objectclass; 
      LONG   objecttype; 
      LONG   event; 
      LONG   (*eventroutine) ( 
                 HNDL   notifyhandle,  
                 LONG   token, 
                 OBID   objectid, 
                 LONG   objecttype, 
                 LONG   objectclass, 
                 LONG   event ); 
  };
  

Fields

classobjectsignature

The identifier class signature MM_NOTIFY_SIGNATURE. This same signature should have been used to allocate the resource tag required by MM_RegisterObject.

name

The user-defined name of the notify object. Only the first MM_MAX_OBJECT_STRING_LEN - 1 characters are significant. The name is required.

token

A user-defined value. This value is returned to the application by calling the eventroutine.

notifytype

Set to zero.

objectclass

Defines the class the event of interest is to occur in. (See Class Types for a list of classes.)

objecttype

Defines the type of object within the class the event of interest is to occur on. This value can be set to -1 indicating a wild card for the object type.

event

Defines the event of interest. (See Notification Events for a list of events.)

(*eventroutine)

A pointer to the event routine that is called when the criteria defined by event, objecttype, and objectclass are met. The parameters to this routine are as follows:

• notifyhandle – the same handle that was returned to the application by MM_RegisterObject when the notify object was registered.
• token – the token that was given when the notify object was registered.
• objectid – the OBID of the object that had the event.
• objecttype – the type of object defined by objectid.
• objectclass – the class objectid belongs to.
• event – the event that objectid had.

See Also

Notify Class