NWDSEGetLocalClassName

Retrieves the name of the eDirectory object class 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)  NWDSEGetLocalClassName  ( 
       NWDSContextHandle   context,  
       nuint32             classID,  
       pnstr               name);

Parameters

context
(IN) Specifies the eDirectory context for the request.
classID
(IN) Specifies the local ID for the eDirectory object class.
name
(OUT) Points to the name of the object class associated with the local ID.

Return Values

0x0000

Successful

Negative Value

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

Remarks

The data structures returned for eDirectory events do not contain object class names. Instead, these structures use local IDs to identify the object class associated with an event. NWDSEGetLocalClassName is used to determine the name of the object class, such as User,that is associated with the object class ID.

Comparisons of IDs are faster than comparisons of text strings. Therefore, to avoid unnecessary processing time, your application should filter on IDs when possible.

The caller must allocate space for the object-class name that is returned. The size of the allocated memory is ((MAX_SCHEMA_NAME_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 NULL termination.

See Also

NWDSEGetLocalClassID