Name

ds_initialize - Initializes the XDS interface

Synopsis

#include <xom.h>
#include <xds.h> OM_workspace ds_initialize(void);

Description

The ds_initialize() function performs any necessary initialization of the XDS application program interface (API), including the creation of a workspace.  It must be called before any other directory interface functions are called.  If it is subsequently called before ds_shutdown(), the function returns NULL. 

Return Values

OM_workspace
Upon successful completion, OM_workspace contains a handle to a workspace in which OM objects can be created and manipulated.  Objects created in this workspace, and only such objects, can be used as parameters to the other directory interface functions.  This function returns NULL if it fails. 

Related Information

Functions: ds_shutdown(3xds).