Open Client Client-Library/C Reference Manual

Home

Open Client Client-Library/C Reference Manual

Chapter 2 Topics

Callbacks

Negotiation callbacks

Defining a negotiation callback

A negotiation callback is defined as follows:

CS_RETCODE CS_PUBLIC
 negotiation_cb(connection, inmsgid,
                 outmsgid, inbuffmt, inbuf, outbuffmt,
                 outbuf, outbufoutlen)
 
 CS_CONNECTION   *connection;
 CS_INT                      inmsgid;
 CS_INT                      *outmsgid;
 CS_DATAFMT            *inbuffmt;
 CS_BYTE                   *inbuf;
 CS_DATAFMT            *outbuffmt;
 CS_BYTE                   *outbuf;
 CS_INT                      *outbufoutlen;

where:

connection is a pointer to the CS_CONNECTION structure representing the connection that is logging into the server.

inmsgid is the type of information that the server is requesting. inmsgid can be any of the following values:

Value of inmsgid	Meaning
CS_MSG_GETLABELS	The server is requesting security labels.
A value < CS_USER_MSGID	The server is requesting a Sybase-defined value.
A user-defined value >= CS_USER_MSGID and <= CS_USER_MAX_MSGID	The Open Server application is requesting an application-defined value. The negotiation callback's must interpret inmsgid.

outmsgid is the type of information that the negotiation callback is returning. This table lists the values that are legal for outmsgid:

Value of outmsgid:	To indicate:
CS_MSG_LABELS	The negotiation callback is returning security labels.
A value < CS_USER_MSGID	The callback is returning a Sybase-defined value.
A user-defined value >= CS_USER_MSGID and <= CS_USER_MAX_MSGID	The callback is returning an application-defined value.

inbuffmt is a pointer to a CS_DATAFMT structure. If the negotiation callback is handling a trusted-user handshake, inbuffmt is NULL. If the negotiation callback is handling a challenge/response handshake, *inbuffmt describes the inbuf challenge key.
inbuf is a pointer to data space. If the negotiation callback is handling a trusted-user handshake, inbuf is NULL. If the negotiation callback is handling a challenge/response handshake, inbuf points to the challenge key.
outbuffmt is a pointer to a CS_DATAFMT structure. The negotiation callback should fill this CS_DATAFMT with a description of the security label or response that it is returning.
Client-Library does not define which fields in the CS_DATAFMT need to be set.
outbuf is a pointer to a buffer. The negotiation callback should place the security label or response in this buffer. This buffer is allocated and freed by Client-Library. Its length is described by outbuffmt−>maxlength.
outbufoutlen is the length, in bytes, of the data placed in *outbuf.

A negotiation callback must return CS_SUCCEED, CS_FAIL, or CS_CONTINUE:

If the callback returns CS_CONTINUE, Client-Library calls the negotiation callback again to generate an additional security label or response.
If the callback returns CS_SUCCEED, Client-Library sends the security label(s) or response(s) to the server.
If the callback returns CS_FAIL, Client-Library aborts the connection process, causing ct_connect to return CS_FAIL.


	Expand Search