Name

ds_shutdown - Deletes a directory workspace

Synopsis

#include <xom.h>
#include <xds.h> DS_status ds_shutdown(
OM_workspace workspace);

Parameters

Input

workspaceSpecifies the workspace (obtained from a call to ds_initialize()) that is to be deleted. 

Description

The ds_shutdown() function deletes the workspace established by ds_initialize() and enables the service to release resources.  All sessions associated with the workspace must be terminated by calling ds_unbind() prior to calling ds_shutdown().  No other directory function can reference the specified workspace after it has been deleted.  However, om_delete() and om_instance() may be called if referring to public objects. 

Return Values

DS_statusDS_SUCCESS if the function completed successfully; otherwise, it indicates the error that has occurred. 

Errors

The following describes a partial list of errors that might be returned.  Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. 

This function can return a DS_C_SERVICE_ERROR (value DS_E_BUSY) if ds_shutdown() is called before all directory connections have been released with ds_unbind(). 

This function can return the error constant DS_NO_WORKSPACE. 

This function does not return a DS_C_COMMUNICATIONS_ERROR or any directory errors. 

Related Information

Functions: ds_initialize(3xds).