NWDSEGetLocalEntryName

Retrieves the name of the eDirectory object associated with the supplied local ID.

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)  NWDSEGetLocalEntryName  ( 
       NWDSContextHandle   context,  
       nuint32             entryID,  
       pnstr               objectName);

Parameters

context
(IN) Specifies the eDirectory context for the request.
entryID
(IN) Specifies the local ID for the eDirectory object.
objectName
(OUT) Points to the name of the eDirectory object associated with the local ID specified by entryID.

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 name returned by NWDSEGetLocalEntryName is dependant upon the settings of the flags associated with the eDirectory context specified by context.

The caller must allocate memory to receive the object name that is 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 is double-byte). One character is used for the NULL terminator.

See Also

NWDSEGetLocalEntryID