Siemens SIMATIC Ident Installation Manual page 17

ComGetNotify
comInt
Messages that are sent to the application at the end of communications operations (if they
have been enabled with "COMEnableEvent") contain further information about the triggering
operation. These are coded in the message parameters "wParam" and "IParam" and can be
extracted using this function.
Parameter
wParam
lParam
*user_id
*event_ptr
*state_ptr
*handle_ptr
Return value
0
≠ 0
Notes
● If "NULL" is transferred with any pointer parameter, the corresponding information is not
● The routine runs several basic plausibility checks of the values of the message
SIMATIC 3964R protocol for Windows 9x/XP/7
Installation Manual, 01/2013, J31069-D0131-U001-A2-7218
(WPARAM wParam,
ComGetNotify
LPARAM lParam,
int *user_id,
int *event_ptr,
int *state_ptr,
init *handle_ptr)
"wParam" parameter of the incoming message
"IParam" parameter of the incoming message
Pointer to storage space for the ID assigned by the user when calling
"COMEnableEvent"
Pointer to the storage location for event type
Pointer to the storage location for the status of the completed operation that
triggered the message
Pointer to storage location for the interface handle from
Function successfully completed
possible error message:
•
returned.
parameters, a full check is however not possible.
COM_UNKNOWN_EVENT
Programming interface
4.1 Functions of the serial interface
ComOpen
17