Name

ds_remove_entry - Removes a leaf entry from the DIT

Synopsis

#include <xom.h>
#include <xds.h> DS_status ds_remove_entry(
OM_private_object session,
OM_private_object context,
OM_object name,
OM_sint ∗invoke_id_return);

Parameters

Input

session(Object(DS_C_SESSION).  The directory session against which this operation is performed.  This must be a private object. 

context(Object(DS_C_CONTEXT)).  The directory context to be used for this operation.  Note that DS_SIZE_LIMIT and DS_­DONT_­DEREFERENCE_­ALIASES do not apply to this operation.  This parameter must be a private object or the DS_­DEFAULT_­CONTEXT constant. 

name(Object(DS_C_NAME)).  The name of the target object entry.  Any aliases in the name are not dereferenced. 

Output

invoke_id_return
(Integer).  Not supported.

Description

The ds_remove_entry() function is used to remove a leaf entry from the directory (either an object entry or an alias entry). 

Return Values

DS_statusIndicates whether or not the entry was deleted. 

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_SYSTEM_ERROR or one of the following DS_C_LIBRARY_ERROR errors:

       •DS_E_BAD_ARGUMENT

       •DS_E_BAD_CONTEXT

       •DS_E_BAD_NAME

       •DS_E_BAD_SESSION

       •DS_E_MISCELLANEOUS

       •DS_E_MISSING_TYPE

       •DS_E_TOO_MANY_OPERATIONS

The function can return the following directory errors:

       •DS_C_NAME_ERROR

       •DS_C_REFERRAL

       •DS_C_SECURITY_ERROR

       •DS_C_SERVICE_ERROR

       •DS_C_UPDATE_ERROR

This function can return a DS_C_COMMUNICATIONS_ERROR, as well as the error constant DS_NO_WORKSPACE.