Netscape ENTERPRISE SERVER 6.0 - NSAPI PROGRAMMER GUIDE Manual page 329

By default, this function refreshes the cache entry if it has expired by making a call
to the function passed to
ref
specified , this function adds a new cache entry by calling the
key
before sending out the response. However if the
parameter and if either the cache entry has expired or the cache entry
flags
corresponding to the
Instead it returns with
If (passed to
ref dr_cache_init
the parameter, and the cache entry corresponding to the
flags
does not exist,
dr_net_write
refreshes the cache if
If (passed to
ref dr_cache_init
is passed and the entry is present in the cache,
DR_IGNORE
the response even if the entry has expired. However, if the entry is not found,
returns
dr_net_write
If (passed to
ref dr_cache_init
but is passed and the entry is present in the cache,
DR_IGNORE
out the response even if the entry has expired. However, if the entry is not found,
calls the
dr_net_write
before sending out the response.
Syntax
PRInt32 dr_net_write(DrHdl hdl, const char *key, PRUint32 klen,
const char *hdr, const char *ftr, PRUint32 hlen, PRUint32 flen,
PRIntervalTime timeout, PRUint32 flags, Request *rq, Session *sn);
Returns
if successful.
IO_OKAY
if an error occurs.
IO_ERROR
if an error in cache handling occurs.
DR_ERROR
if the cache has expired.
DR_EXPIR
Parameters
is a persistent handle created by the
DrHdl hdl
is the key to cache, search, or refresh.
const char *key
is the length of the key in bytes.
PRUint32 klen
is any header data (which can be NULL).
const char *hdr
is any footer data (which can be NULL).
const char *ftr
dr_cache_init
does not exist,
key dr_net_write
.
DR_EXPIR
) is NULL, the DR_CHECK flag is not passed in
fails with
DR_ERROR
is not NULL and
ref
) is NULL and the
.
DR_ERROR
) is not NULL and the
function and stores the new entry returned from
ref
Appendix F
. If no cache entry is found with the
flag is passed in the
DR_CHECK
does not send any data out.
key
. However,
dr_net_write
is not passed.
DR_CHECK
flag is not passed but
DR_CHECK
dr_net_write
DR_CHECK
dr_net_write
dr_cache_init
Dynamic Results Caching Functions
function
ref
has expired or
sends out
flag is not passed
sends
ref
function.
329