Netscape ENTERPRISE SERVER 6.1, Руководство пользователя

Страница: 312 / 373

Privatization of Some Data Structures
312 Netscape Enterprise Server NSAPI Programmer’s Guide • April 2002 (Draft)
Privatization of Some Data Structures
In iPlanet Web Server 4.
x
, some data structures were moved from
nsapi.h
to
nsapi_pvt.h
. The data structures in
nsapi_pvt.h
are now considered to be
private data structures, and you should not write code that accesses them directly.
Instead, use accessor functions. We expect that very few people have written
plugins that access these data structures directly, so this change should have very
little impact on customer-defined plugins. Look in
nsapi_pvt.h
to see which data
structures have been removed from the public domain and to see the accessor
functions you can use to access them from now on.
Plugins written for Enterprise Server 3.
x
that access contents of data structures
defined in
nsapi_pvt.h
will not be source compatible with versions 4.
x
and 6.x;
that is, it will be necessary to
#include "nsapi_pvt.h"
in order to build such
plugins from source. There is also a small chance that these programs will not be
binary compatible with versions 4.
x
and 6.x, because some of the data structures in
nsapi_pvt.h
have changed size. In particular, the
directive
structure is larger,
which means that a plugin that indexes through the directives in a
dtable
will not
work without being rebuilt (with
nsapi_pvt.h
included).
We hope that the majority of plugins do not reference the internals of data
structures in
nsapi_pvt.h
, and therefore that most existing NSAPI plugins will be
both binary and source compatible with Enterprise Server 6.0.
session
A
session
is the time between the opening and closing of the connection between the
client and the server. The
Session
data structure holds variables that apply session
wide, regardless of the requests being sent, as shown here: