NWDSReadNDSInfo

Reads NDSPING information into a buffer for retrieval.

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 <nwdsmisc.h> 
   
  N_EXTERN_LIBRARY (NWDSCCODE)  NWDSReadNDSInfo  ( 
     NWCONN_HANDLE   connHandle,  
     nflag32         requestedFields,  
     pBuf_T          resultBuffer);

Pascal

  uses netwin32 
   
  Function NWDSReadNDSInfo 
    (connHandle : NWCONN_HANDLE; 
     requestedFields : nflag32; 
     resultBuffer : pBuf_T; 
  ) : NWDSCCODE;

Parameters

connHandle

(IN) Specifies a connection handle to the eDirectory server.

requestedFields

(IN) Specifies the DSPING flags that control the information returned (see Section 5.19, eDirectory Ping Flags).

resultBuffer

(OUT) Points to the buffer receiving the requested data.

Return Values

These are common return values.

0x0000 0000

SUCCESSFUL

nonzero value

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

Remarks

NWDSReadNDSInfo places fields of information designated by Section 5.19, eDirectory Ping Flags into a reply buffer. These fields can then be retrieved one at a time with NWDSGetNDSInfo.

For instructions on how to use NWDSReadNDSInfo, see Accessing eDirectory Ping Information.

NCP Calls

See Also

NWDSGetNDSInfo, NWGetNLMInfo