Authenticates to the Message Feed server. Each client submitting messages to the Message Feed server must authenticate itself with a name and a password.
MFP.Authenticate hMFP [RequestId request-id] User user Password password;
hMFP
– The handle to the Message Feed connection. This is a record of type MFP.Handle
.request-id
– Identifies this request. It is returned in the reply received by the MFP.GetReply
statement in order to correlate a reply with its request. This is an optional expression of type integer.user
– The user name for the Message Feed client. This is an expression of type string.password
– The password for the specified user. This is an expression of type string.When an error occurs, the function throws an exception of type MFP.$Exception
and sets the $Error
reserved variable to one of the following below values:
MFP.$Error_ErrorAuthenticateInvalidid
– The hMFP
parameter refers an unknown connection handle.MFP.$Error_ErrorAuthenticateFailed
– Failed to send the authenticate request to the Message Feed server.
... MFP.Authenticate $hMFP User "user" Password "passwd"; MFP.GetReply $hMFP Reply $Reply; IF $Reply.$Status <> MFP.$ReplyStatus_Ok { LOG FORMAT("failed to authenticate: %s", MFP.StatusToString($Reply.$Status)); EXIT 1; } ... |