NWDSReadObjectDSIInfo

Returns the DSI object information not stored in the attributes of an 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) NWDSReadObjectDSIInfo  ( 
     NWDSContextHandle   context,  
     pnstr8              object,  
     nuint32             infoLength,  
     nptr                objectInfo);

Pascal

  uses netwin32 
   
  Function NWDSReadObjectDSIInfo  ( 
     context : NWDSContextHandle; 
     object : pnstr8; 
     infoLength : nuint32; 
     objectInfo : nptr 
  ) : 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.

infoLength

(IN) Specifies the size of the objectInfo buffer.

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

Object information can be useful to applications browsing the eDirectory tree.

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

The caller must allocate sufficient memory to contain the data elements specified by the Section 5.11, DCK_DSI_FLAGS Values. The default settings return the object's entry flags, subordinate count, modification time, base class, RDN, and DN.

To read the information in the objectInfo buffer, use the NWDSGetDSIInfo function.

NCP Calls

See Also

NWDSGetDSIInfo, NWDSGetObjectNameAndInfo, NWDSRead, NWDSReadObjectInfo