Netscape ENTERPRISE SERVER 6.1, Manual

Page: 176 / 373

NSAPI Functions (in Alphabetical Order)
176 Netscape Enterprise Server NSAPI Programmer’s Guide • April 2002 (Draft)
Syntax
int request_header(char *name, char **value, Session *sn, Request
*rq);
Returns
A result code,
REQ_PROCEED
if the header was found,
REQ_ABORTED
if the header
was not found,
REQ_EXIT
if there was an error reading from the client.
Parameters
char *name
is the name of the header.
char **value
is the address where the function will place the value of the
specified header. If none is found, the function stores a NULL.
Session *sn
is the Session.
Request *rq
is the Request.
The
Session
and
Request
parameters are the same as the ones passed into your
SAF.
See also
request_create, request_free
request_stat_path
The
request_stat_path
function returns the file information structure for a
specified path or, if none is specified, the
path
entry in the
vars
pblock in the
specified Request structure. If the resulting file name points to a file that the server
can read,
request_stat_path
returns a new file information structure. This
structure contains information on the size of the file, its owner, when it was
created, and when it was last modified.
You should use
request_stat_path
to retrieve information on the file you are
currently accessing (instead of calling
stat
directly), because this function keeps
track of previous calls for the same path and returns its cached information.
Syntax
struct stat *request_stat_path(char *path, Request *rq);
Returns
Returns a pointer to the file information structure for the file named by the
path
parameter. Do not free this structure. Returns NULL if the file is not valid or the
server cannot read it. In this case, it also leaves an error message describing the
problem in
rq->staterr
.