ReceiveRequest Method  
 

Receive the request that was sent by the client to the server.

Syntax

object.ReceiveRequest( ClientId, Buffer, [Length] )

Parameters

ClientId
An integer that identifies the client session.
Buffer
A string variable or byte array that is passed by reference which will contain any request data submitted by the client.
Length
An optional integer value that specifies the maximum amount of data returned by the method. If this parameter is omitted the entire request buffer will be returned. If a fixed length string or byte array is provided as the buffer, the maximum amount of data returned is limited by the size of the buffer.

Return Value

A value of zero is returned if the method completed successfully. Otherwise, a non-zero error code is returned which indicates the cause of the failure.

Remarks

The ReceiveRequest method is called within an OnCommand event handler to process the command issued by the client and return information about the request to the server application. It is only necessary for the application to call this method if it wants to implement its own custom handling for a command.

It is recommended that you only use this method to process custom commands and not standard commands such as GET and POST. This ensures that the appropriate security checks are performed and the response conforms to the protocol standard. After the request data has been processed, the application should use the SendResponse or SendError method to send a response back to the client indicating success or failure.

This method may only be called once per command issued by the client.

See Also

SendError Method, SendResponse Method, OnCommand Event