NWDSGetDSVerInfo

Returns NDS/eDirectory version information.

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)  NWDSGetDSVerInfo  ( 
     NWCONN_HANDLE   conn,  
     pnuint32        dsVersion,  
     pnuint32        rootMostEntryDepth,  
     pnstr8          sapName,  
     pnuint32        flags,  
     punicode        treeName);

Pascal

  uses netwin32 
   
  Function NWDSGetDSVerInfo 
    (conn : NWCONN_HANDLE; 
     Var dsVersion : nuint32; 
     Var rootMostEntryDepth : nuint32; 
     sapName : pnstr8; 
     Var flags : nuint32; 
     treeName : punicode 
  ) : NWDSCCODE;

Parameters

conn: (IN) Specifies the connection handle to an eDirectory server.
dsVersion: (OUT) Points to the DS.NLM build version.
rootMostEntryDepth: (OUT) Points to the number of levels to the root-most object.
sapName: (OUT) Points to the tree name where the server is contained. The value is in the SAP form (ASCII characters set restricted by SAP).
flags: (OUT) Returns 0x00000001 if the server's root-most partition is a master replica.
treeName: (OUT) Points to the "enabled" tree name (in the Unicode character set).

Return Values

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

Remarks

NWDSGetDSVerInfo returns version information regarding the DS.NLM running on a specific server. Each return value is optional (that is, passing a NULL as the pointer disables the return of the information).

To return the letter with the NDS/eDirectory version, use the NWDSReadNDSInfo function.

NCP Calls

None