NWDSGetDSIInfo

Returns 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 <nwdsbuft.h> 
   
  N_EXTERN_LIBRARY (NWDSCCODE) NWDSGetDSIInfo  ( 
     NWDSContextHandle   context,  
     nptr                buf,  
     nuint32             bufLen,  
     nuint32             infoFlag,  
     nptr                data);

Pascal

  uses netwin32 
   
  Function NWDSGetDSIInfo  ( 
     context : NWDSContextHandle; 
     buf : nptr; 
     bufLen : nuint32; 
     infoFlag : nuint32; 
     data : nptr 
  ) : NWDSCCODE;

Parameters

context: (IN) Specifies the NDS context for the request.
buf: (IN) Points to the buffer returned from previously calling the NWDSRead, NWDSReadObjectDSIInfo, NWDSList or NWDSSearch functions.
bufLen: (IN) Specifies the length of the buf parameter.
infoFlag: (IN) Specifies the data element to be extracted from the buffer pointed to in the buf parameter (see Section 5.11, DCK_DSI_FLAGS Values).
data: (OUT) Points to a buffer to receive the data element value.

Return Values

0x0000 0000	SUCCESSFUL
nonzero value	Nonzero values indicate errors. See NDS Return Values (–001 to –799).

Remarks

The NWDSReadObjectDSIInfo function returns data regarding an eDirectory object. The NWDSGetDSIInfo function extracts the individual data elements from the reply buffer. The returned "data" is formatted according to the data type of the element referred to by the Section 5.11, DCK_DSI_FLAGS Values. The buffer pointed to by the data parameter must be large enough for the data type of the element.

The DSI information can be retrieved in any order and does not have to follow the order of the DSI_OUTPUT_FIELDS flag.

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

NCP Calls

None