Command Reply Arguments
The SILC Client Library 'command_reply client operation (which is part of the
SilcClientOperation callback functions) returns command replies
from the SILC Server for commands that the client has earlier sent to the
server. The 'command_reply' client operation implementation has a variable
argument list to deliver SilcCommand
specific arguments to the application. This document describes these
arguments for all command replies to help SILC client software developers
to process them.
NOTE: The following list of command reply arguments are sent when
the command was executed successfully. If an error occurred, the
`command_reply' client operation's 'success' argument is FALSE, and the
'status' argument includes the error status. In this case the arguments
returned are dependent of the 'status' argument. See all
SilcStatus error arguments for these
arguments.
command_reply Client Library operation
The 'command_reply' client operation callback function prototype is as follows:
void (*command_reply)(SilcClient client, SilcClientConnection conn,
SilcCommand command, SilcStatus status,
SilcStatus error, va_list ap);
The first argument 'client' is the SILC Client Library context, the 'conn'
is the context for the connection to the remote server, the 'cmd_payload'
is the raw SilcCommandPayload and application usually ignores it, the
'success' boolean value indicates whether the earlier command was a success
or not, the 'command' is the command reply enumeration, and the 'status'
indicates the status of the command reply. If 'success' is FALSE then
'status' includes error status (see SilcStatus
error arguments).
Rest of the arguments are 'command' specific and implementation should
handle them by the SilcCommand for example in a switch statement.
The commands are definctory,can be omitted.
The SILC Toolkit is generic C and C++ code and should work with any
SDK. If you don't have SDK already installed, install the latest
version you can find. The links to SDKs are found in the Carbide.c++
instructions after installation. If you already have SDK in your
system, you should use that.
After installation import the SILC Toolkit project to Carbide.c++ from the
symbian/ subdirectory in the SILC Toolkit package.
Please read the README.SYMBIAN from the SILC Toolkit package for complete
building instructions.
|
SILC Toolkit Reference Manual
SILC VCard Interface