NWDSEGetLocalClassID

Retrieves the local ID for the specified object class.

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

Parameters

context
(IN) Specifies the eDirectory context for the request.
name
(IN) Points to the name of the object class whose local ID is to be returned.
id
(OUT) Points to the local class ID for the specified object class.

Return Values

0x0000

Successful

Negative Value

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

Remarks

The local ID of an object class is valid only on the server on which NWDSEGetLocalClassID is called. For this reason, this ID is called a local ID.

The data structures returned for DS events do not contain object class names. Instead, these structures use local IDs to identify the object class associated with an event. NWDSEGetLocalClassID is used to determine the local ID for an object class, such as User, so the ID can be used for comparison operations.

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

NWDSEGetLocalClassName