Novell Documentation: eDirectory Libraries for C

NWDSEConvertEntryName

Converts the object names returned in the DSEEntryInfo structure to a form that is consistent with the functions whose names begin with NWDS.

Local Servers:blocking
Remote Servers:N/A
Classification:4.x, 5.x, 6.x
Platform:NLM
Service:eDirectory Event

Syntax

    #include <nwdsdsa.h> 
    #include <nwdsevnt.h> 
     
    N_EXTERN_LIBRARY (NWDSCCODE)  NWDSEConvertEntryName  ( 
       NWDSContextHandle   context,  
       const punicode      DSEventName,  
       pnstr               objectName);

Parameters

context: (IN) Specifies the Directory context for the request.
DSEventName: (IN) Points to the object name to be converted.
objectName: (OUT) Points to the object’s name in a form consistent with the eDirectory functions.

Return Values

0x0000	Successful
Negative value	Negative values indicate errors. For error values, see NDS Return Values (NDK: Novell eDirectory Core Services).

Remarks

The form of the object names returned in the dn and newDN fields of the DSEEntryInfo structure is not consistent with the form used by the eDirectory functions. These names must be converted by NWDSEConvertEntryName before you use them with eDirectory functions.

The format of the name returned in newDN is determined by the settings in the eDirectory context.

The caller must allocate space for the object name to be returned. The size of the allocated memory is ((MAX_DN_CHARS)+1)*sizeof(character size) where character size is 1 for single-byte characters, and 2 for double-byte characters (Unicode characters are double-byte). One character is used for the NULL terminator.