RSA Security logo

RSA BSAFE Cert-C
API Reference

TRANSPORT_INFO Struct Reference

Specifies the location of network resources and any non-transparent proxies that exist between the client and server.

It includes two LIST_OBJ objects that contain ITEM structures whose data members point to URLs. Add items to a LIST_OBJ object by calling the C_AddItemToList() function. The TRANSPORT_INFO structure is used by many service providers that operate over a network.

As is the case with most Cert-C data structures, it is recommended that the memory corresponding to this data structure be initialized with zero-valued bytes before use. This coding practice ensures reliable behavior in the future, should the structure definition grow or change in the future. In this way, all newly added or changed fields will always automatically be initialized to a reasonable, known, defauult initial value. There are fields added to this structure in Cert-C 2.5. If older code is being moved into this structure, ensure that all the members of this structure are initialized. The following code will perform the initialization on all members of the structure:

      TRANSPORT_INFO transInfo; 
      T_memset((POINTER)&transInfo, 0, sizeof(transInfo));
Using sizeof processes all members, regardless of the number of members.
Data Fields
destList A LIST_OBJ object that contains a list of destination URLs, represented as ITEM structures. If no destination URLs are specified, set this field to (LIST_OBJ)0. For example, a destination URL can be specified as:
    http://server.company.com:80/cgi-bin/responder
proxyList A LIST_OBJ object that contains a list of non-transparent proxies as URLs, represented as ITEM structures. In general, these URLs must contain a protocol identifier so that proxies can be matched to destinations of the same protocol types used in destList. If no proxy URLs are specified, set this field to (LIST_OBJ)0. For example, a proxy URL can be specified as:
 
    http://proxyserver.company.com:8080
timeOut The network timeout, in seconds.

#include <transprt.h> 

00080 typedef struct {
00081   LIST_OBJ          destList;     /* transport destination(s) */
00082   LIST_OBJ          proxyList;    /* proxy(s) to destination(s) */
00083   unsigned int      timeOut;      /* network timeout, in seconds */
00084 } TRANSPORT_INFO;
The documentation for this struct was generated from the following file:

RSA BSAFE® Cert-C 2.7 API Reference