RSA Security logo

RSA BSAFE Cert-C
API Reference

httpapi.h File Reference

This file defines functions and structures used with HTTP-transported requests and responses.

#include "certc.h"
#include "transprt.h"

Go to the source code of this file.

Data Structures

struct  HTTP_REQUEST_INFO
 Holds information associated with an HTTP-transported request. More...

struct  HTTP_RESPONSE_INFO
 Holds information associated with an HTTP-transported response. More...


Functions

int C_SendHTTPRequest (CERTC_CTX ctx, HTTP_REQUEST_INFO *pRequestInfo, TRANSPORT_INFO *pTransportInfo, HTTP_RESPONSE_INFO *pResponseInfo)
 Applies an HTTP method to the specified URL using the supplied input data and metadata headers and returns status, data and response metadata. More...

Function Documentation

int C_SendHTTPRequest (  CERTC_CTX    ctx,
HTTP_REQUEST_INFO *    pRequestInfo,
TRANSPORT_INFO *    pTransportInfo,
HTTP_RESPONSE_INFO *    pResponseInfo
)  ;
 

Applies an HTTP method to the specified URL using the supplied input data and metadata headers and returns status, data and response metadata. This function is not a general-purpose HTTP transport function for use by applications. Its use is generally limited to Cert-C service providers, but can be used by other RSA Security toolkits that require simple HTTP transport functionality. Applications that require general-purpose HTTP functionality should consider using a third-party network transport library; for example, the libwww library from the World Wide Web Consortium (W3C). For more information on the libwww library, see the W3C site at http://www.w3c.org.

Parameters:
ctx This input parameter contains the Cert-C context handle.
pRequestInfo This input parameter is a pointer to an HTTP_REQUEST_INFO structure that specifies the HTTP method, as well as any data and metadata, to apply to the URL specified in the pTransportInfo.
pTransportInfo This input parameter contains the information necessary to specify the target URL, as well as other required transport-related information.
pResponseInfo This output parameter contains the information received in response to the requested HTTP operation. Request status, returned data, and metadata are included in the data returned in this structure.
Returns:
If successful, returns 0. If not, returns a Cert-C error code.


RSA BSAFE® Cert-C 2.7 API Reference