NWDSEGetLocalAttrName

Retrieves the name of the eDirectory attribute 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)  NWDSEGetLocalAttrName  ( 
       NWDSContextHandle   context,  
       nuint32             attrID,   
       pnstr               name);

Parameters

context
(IN) Specifies the eDirectory context for the request.
attrID
(IN) Specifies the local ID for the schema attribute.
name
(OUT) Points to the name of the attribute 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 attribute names. Instead, these structures use local IDs to identify the attribute associated with the event. NWDSEGetLocalAttrName is used to map the local attribute ID found in the structures, to a text form of the name, such as "Telephone Number."

Comparisons of IDs is 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 attribute name pointed to by name. 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

NWDSEGetLocalAttrID