NWDSReadObjectInfo

Returns object information not stored in the attributes of the object.

Local Servers:blocking
Remote Servers:blocking
NetWare Server:4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98, Windows 2000, Windows XP
Library:Cross-Platform NDS (NET*.*)
Service:NDS

Syntax

C

  #include <nwnet.h> 
  or 
  #include <nwdsdsa.h> 
   
  N_EXTERN_LIBRARY (NWDSCCODE)  NWDSReadObjectInfo  ( 
     NWDSContextHandle   context,  
     pnstr8              object,  
     pnstr8              distinguishedName,  
     pObject_Info_T      objectInfo);

Pascal

  uses netwin32 
   
  Function NWDSReadObjectInfo 
    (context : NWDSContextHandle; 
     objectName : pnstr8; 
     distinguishedName : pnstr8; 
     objectInfo : pObject_Info_T 
  ) : NWDSCCODE;

Parameters

context

(IN) Specifies the NDS context for the request.

object

(IN) Points to the name of the object for which information is to be returned.

distinguishedName

(OUT) Points to the object name, which may be distinguished or relative depending upon the context flags.

objectInfo

(OUT) Points to the non-attribute information about the object.

Return Values

0x0000 0000

SUCCESSFUL

nonzero value

Nonzero values indicate errors. See NDS Return Values (–001 to –799).

Remarks

This function returns the name of the base class used to create the object, entry flags, modification time, and the number of objects that are subordinate to this object. This information can be useful to applications browsing the eDirectory tree. The flags set on the context handle influence the information returned. For more information, see Section 5.6, Context Keys and Flags.

If aliases are to be dereferenced (the context flag associated with DSV_DEREF_ALIASES is set) and object passes an alias name for the object, the name pointed to by distinguishedName is the dereferenced name of the object.

The caller must allocate memory to hold the distinguished name of the object. The size of the memory is (MAX_DN_CHARS+1)*sizeof(character size), where character size is 1 for single-byte characters, and 2 for Unicode characters (Unicode characters are always 16 bits). One character is used for NULL termination.

NCP Calls

See Also

NWDSRead