Safeguard Reference Manual (G06.29+, H06.08+, J06.03+)

Event-Exit-Process Commands
Safeguard Reference Manual — 520618-030
15 - 16
Interprocess Communication Messages
Message_Tag INT(32) Indicates continuity of ongoing dialog for
challenge/response or password dialog
interactions. The initial value is 0. This field
is filled in by the event-exit process so that it
can identify different events when it is
handling multiple message dialogs.
Safeguard preserves the message tag and
returns it to the event exit in subsequent
messages during ongoing dialog.
For Logon^Abort messages, this tag
id
entifies the particular logon dialog that has
just been terminated.
Error INT A return value that indicates the event exit’s
response to th
e message. The value is
always 0 when the message is sent. Valid
return values are as follows:
0 = OK (The event exit successfully
processed t
he message and is returning a
valid status.)
3501 = Message size exceeded maximum
expect
ed message size.
3503 = Event exit process does not support
this message d
ata type.
3505 = Event exit’s supported message
ve
rsion is lower than Min_MSG_Version in
this message.
Status INT Status of the reply message. This field is
va
lid only if the Error field contains the value
0. The valid values for this field are:
Access Control (result of access attempt)
1 = yes
3 = no
2 = no record
Logon (result of logon attempt)
0 = authenticated
20 = denied
70 = continue authentication
500-999 = defined by event exit
(A status of 500-999 is recognized by
USER
_AUTHENTICATE only when Error
does not equal 0.)
FEA 22 bytes
A future expansion area; currently filled with
zeros.
Table 15-2. Header_Data (page 2 of 2)