Structure

  typedef struct 
     nuint           authenticationState ; 
     nuint           broadcastState ; 
     nuint32         connRef ; 
     nstr            treeName [NW_MAX_TREE_NAME_LEN]; 
     nuint           connNum ; 
     nuint32         userID ; 
     nstr            serverName [NW_MAX_SERVER_NAME_LEN]; 
     nuint           NDSState ; 
     nuint           maxPacketSize ; 
     nuint           licenseState ; 
     nuint           distance ; 
     NWCCVersion     serverVersion ; 
  #ifdef NWCC_INFO_VERSION_2 
     pNWCCTranAddr   tranAddr ;
  #endif 
  #ifdef NWCC_INFO_VERSION_3
     nuint32         identityHandle;
  #endif 
  } NWCCConnInfo;
  

Delphi Structure

  NWCCConnInfo = packed Record 
      authenticationState :  nuint;  
      broadcastState :  nuint;  
      connRef :  nuint32;  
      treeName : Array[0..NW_MAX_TREE_NAME_LEN-1] Of nstr;  
      connNum :  nuint;  
      userID :  nuint32;  
      serverName : Array[0..NW_MAX_SERVER_NAME_LEN-1] Of nstr;  
      NDSState : nuint;  
      maxPacketSize : nuint;  
      licenseState : nuint;  
      distance : nuint;  
      serverVersion : NWCCVersion; 
     {$IFDEF NWCC_INFO_VERSION_2} 
        tranAddr : pNWCCTranAddr; 
     {$ENDIF}
     {$IFDEF NWCC_INFO_VERSION_2}
        identityHandle : nuint32;
     {$ENDIF}
    End;
  

Fields

authenticationState

Specifies the NDS™ authenticated state of the specified connection (see Section 5.5, NWCC_INFO_AUTHENT_STATE Values).

broadcastState

Specifies the message broadcast state of the specified connection (see Section 5.6, NWCC_INFO_BCAST_STATE Values).

connRef

Specifies the connection reference for the specified connection handle.

treeName

Specifies the tree name of the specified connection if attached to NDS. It has a maximum length of NW_MAX_TREE_NAME_LEN.

connNum

Specifies the connection number for the specified connection.

userID

Specifies the user for the connection.

serverName

Specifies the name of the server the connection is attached to. It has a maximum length of NW_MAX_SERVER_NAME_LEN.

NDSState

Specifies if the connection supports NDS (see Section 5.8, NWCC_INFO_NDS_STATE Values).

maxPacketSize

Specifies the maximum length of an Internet packet that can be supported by this connection.

licenseState

Specifies if the connection is licensed (see Section 5.7, NWCC_INFO_LICENSE_STATE Values).

distance

Specifies distance in milliseconds to the given server (55 milliseconds = 1 tick).

serverVersion

Points to the NWCCVersion structure returning the NetWare version.

tranAddr

Points to the NWCCTranAddr structure returning the type.

identityHandle

Specifies the identity of the connection.

Remarks

The treeName structure field is used to give the tree name of a particular connection in functions such as NWCCGetAllConnRefInfo and NWCCGetConnRefInfo. You must strip off the trailing `_’ characters (that are padding the tree name out to the maximum length) to get a matching valid tree name. Other functions that depend on a valid tree name already strip the `_’ characters.