USER_INFO

Returns information about a user connection.

Service:Server Environment
Defined In:nwfse.h

Structure

  typedef struct 
  { 
     nuint32   connNum ; 
     nuint32   useCount ; 
     nuint8    connServiceType ; 
     nuint8    loginTime [7]; 
     nuint32   status ; 
     nuint32   expirationTime ; 
     nuint32   objType ; 
     nuint8    transactionFlag ; 
     nuint8    logicalLockThreshold ; 
     nuint8    recordLockThreshold ; 
     nuint8    fileWriteFlags ;    
     nuint8    fileWriteState ; 
     nuint8    filler ; 
     nuint16   fileLockCount ; 
     nuint16   recordLockCount ; 
     nuint8    totalBytesRead [6]; 
     nuint8    totalBytesWritten [6]; 
     nuint32   totalRequests ; 
     nuint32   heldRequests ; 
     nuint8    heldBytesRead [6]; 
     nuint8    heldBytesWritten [6]; 
  } USER_INFO;

Delphi Structure

  uses calwin32 
   
   USER_INFO = packed Record 
      connNum : nuint32;  
      useCount : nuint32;  
      connServiceType : nuint8;  
      loginTime : Array[0..6] Of nuint8;  
      status : nuint32;  
      expirationTime : nuint32;  
      objType : nuint32;  
      transactionFlag : nuint8;  
      logicalLockThreshold : nuint8;  
      recordLockThreshold : nuint8;  
      fileWriteFlags : nuint8;
      fileWriteState : nuint8;  
      filler : nuint8;  
      fileLockCount : nuint16;  
      recordLockCount : nuint16;  
      totalBytesRead : Array[0..5] Of nuint8; 
      totalBytesWritten : Array[0..5] Of nuint8; 
      totalRequests : nuint32;  
      heldRequests : nuint32;  
      heldBytesRead : Array[0..5] Of nuint8; 
      heldBytesWritten : Array[0..5] Of nuint8; 
    End;

Fields

connNum
Specifies the connection number of the user.
useCount
Specifies if the connection is in use:
  • 1 Connection is in use
  • 0 Connection is not in use
connServiceType
Specifies the connection type.
loginTime
Specifies the time the user logged in.
status
Specifies the status of the connection.
expirationTime
Specifies the expiration time.
objType
Specifies the object type of the user (usually 0x0100).
transactionFlag
Specifies the transaction tracking information.
logicalLockThreshold
Specifies the maximum number of logical locks a user can have.
recordLockThreshold
Specifies the maximum number of record locks the user can have.
fileWriteFlags
Specifies the writing status (includes active and stop bits):
  • 1 FSE_WRITE
  • 2 FSE_WRITE_ABORTED
fileWriteState
Specifies the writing status:
  • 0 FSE_NOT_WRITING
  • 1 FSE_WRITE_IN_PROGRESS
  • 2 FSE_WRITE_BEING_STOPPED
filler
Is unused.
fileLockCount
Specifies the number of files the user locked.
recordLockCount
Specifies the number of records the user locked.
totalBytesRead
Specifies the number of bytes the user read (48-bit value).
totalBytesWritten
Specifies the number of bytes the user wrote (48-bit value).
totalRequests
Specifies the number of requests the user sent.
heldRequests
Specifies the number of requests held for accounting purposes.
heldBytesRead
Specifies the number of bytes the user read that have a hold on them for accounting purposes.
heldBytesWritten
Specifies the number of bytes the user wrote that have a hold on them for accounting purposes.

Remarks

connServiceType can have the following values:

status can have the following values: