NWDSEGetLocalEntryID

Retrieves the local ID for the specified eDirectory object.

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

Parameters

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

Return Values

0x0000

Successful

Negative Value

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

Remarks

The name specified by objectName is relative to the context specified by context.

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

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

See Also

NWDSEGetLocalEntryName