NWDSEGetLocalAttrID

Retrieves the local ID of a specified eDirectory attribute.

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)  NWDSEGetLocalAttrID  ( 
       NWDSContextHandle   context,  
       const pnstr         name,  
       pnuint32            id);

Parameters

context
(IN) Specifes the eDirectory context for the request.
name
(IN) Points to the name of the eDirectory attribute whose local ID is to be returned.
id
(OUT) Points to the local ID for the eDirectory attribute.

Return Values

0x0000

Successful

Negative Value

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

Remarks

An attribute’s local ID is valid only for the server on which NWDSEGetLocalAttrID is called. For this reason, this ID is called a local ID.

The data structures returned for eDirectory events do not contain attribute names. Instead, these structures use local IDs to identify the attribute that is associated with the event. NWDSEGetLocalAttrID is used to map an attribute name, such as User, and convert it to a local ID that can be used to compare with the local ID in an event structure.

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

See Also

NWDSEGetLocalAttrName