Kaspersky Security Center Automation  10.0
List of host attributes

List of host attributes is presented below.

"KLHST_WKS_ID" Integer Host id Read-only
"KLHST_WKS_DN" String Host display name  
"KLHST_WKS_GROUPID" Integer Id of administration group (see IKlAkGroups) where host is located Host may be moved by changing value of this attribute
"KLHST_WKS_CREATED" Time Time of host record creation Read-only
"KLHST_WKS_LAST_VISIBLE" Time Last host visibility time  
"KLHST_WKS_LAST_INFOUDATE" Time Last update host information time Read-only
"KLHST_WKS_STATUS" Integer Host status – bit set
  • bit 0 set if host is visible,
  • bit 2 set if Network Agent is installed
  • bit 3 set if Network Agent is "alive"
  • bit 4 set if real-time protection is installed
  • bit 5 set if the computer has been temporarily switched into current server as a result od NLA profile switching (supported by Administration Server 7.0 or higher)
Read-only
"KLHST_WKS_LAST_UPDATE" Time Last anti-virus update time Read-only
"KLHST_WKS_LAST_NAGENT_CONNECTED" Time Last Network Agent connection time Read-only
"KLHST_WKS_KEEP_CONNECTION" Boolean "Keep connection" flag – connection between host and administration server will be persistent if this attribute is set to true. Use with care – persistent connection took much system resources on server. There may be no more than 100 hosts with this flag set.
"KLHST_WKS_HOSTNAME" String Host name – a unique server-generated string Read-only
"KLHST_INSTANCEID" String Nagent id – a unique string. Empty string if no Network Agent installed. Read-only
"KLHST_WKS_WINHOSTNAME" String Host windows (NetBIOS) name  
"KLHST_WKS_WINDOMAIN" String Name of NT domain or workgroup  
"KLHST_WKS_DNSDOMAIN" String DNS suffix  
"KLHST_WKS_DNSNAME" String DNS name without DNS suffix  
"KLHST_WKS_CTYPE" Integer

"Computer type". Bit set.

  • Bit 0 – Workstation
  • Bit 1 – Server
  • Bit 2 – Any server running with Microsoft SQL Server
  • Bit 3 – Primary domain controller
  • Bit 4 – Backup domain controller
  • Bit 5 – Server running the Timesource service
  • Bit 6 – Apple File Protocol server
  • Bit 7 – Novell server
  • Bit 8 – Domain member
  • Bit 9 – Server sharing print queue
  • Bit 10 – Server running dial-in service
  • Bit 11 – Some Unix
  • Bit 12 – Windows NT/2000/XP/2003/Vista workstation or server
  • Bit 13 – BSD or Windows for Workgroups (depending on KLHST_WKS_PTYPE)
  • Bit 14 – Microsoft File and Print for NetWare
  • Bit 15 – Windows NT/2000/2003 server that is not a domain controller
  • Bit 16 – Server that can run the browser service
  • Bit 17 – Server running a browser service as backup
  • Bit 18 – Server running the master browser service
  • Bit 19 – Server running the domain master browser
  • Bit 20 – OSF
  • Bit 21 – VMS or Linux (depending on KLHST_WKS_PTYPE)
  • Bit 22 – Windows 9x/Me
  • Bit 23 – Root of a DFS tree
  • Bit 24 – NT Cluster
  • Bit 25 – IBM DSS (Directory and Security Services) or equivalent

 
"KLHST_WKS_PTYPE" Integer

"Platform type". One of following constants.

  • 0 – MSDOS, Windows 3.xx, Windows 9x/Me
  • 1 – OS/2
  • 2 – Windows NT/2000/XP/2003/Vista
  • 3 – OSF
  • 4 – VMS
  • 5 – Novell
  • 6 – Linux
  • 7 – BSD
  • 8 – Windows Mobile
  • 9 – Symbian Mobile
  • 10 – Mac OS X

 
"KLHST_WKS_OS_VER_MAJOR" Integer Major part of operating system version  
"KLHST_WKS_OS_VER_MINOR" Integer Minor part of operating system version  
"KLHST_WKS_LAST_FULLSCAN" Time Time of last full scan for viruses  
"KLHST_WKS_VIRUS_COUNT" Integer Number of viruses found Read-only
"KLHST_WKS_RTP_STATE" Integer State of real-time protection. Possible values are listed below.
  • 0 – Unknown
  • 1 – Stopped
  • 2 – Suspended
  • 3 – Starting
  • 4 – Running (if anti-virus application does not support categories of state Running)
  • 5 – Running with maximum protection
  • 6 – Running for maximum speed
  • 7 – Running with recommended settings
  • 8 – Running with custom settings
  • 9 – Failure
Read-only
"KLHST_WKS_RTP_ERROR_CODE" Integer Real-time protection error code Read-only
"KLHST_WKS_COMMENT" String Comments  
"KLHST_WKS_IP_LONG" Long Host ip address (in little-endian byte order)  
"KLHST_WKS_CONNECT_IP_LONG" Long Host "connection ip" address (in little-endian byte order) Read-only
"KLHST_WKS_FROM_UNASSIGNED" Boolean true if host is located in "Unassigned computers" or its subgroup Read-only
"KLHST_WKS_STATUS_ID" Integer Extended status id
  • 0 – OK
  • 1 – Critical
  • 2 – Warning
Read-only
"KLHST_WKS_STATUS_MASK" Integer

Extended status mask, bit set

  • bit 0 – Host with Network Agent installed is online but network agent is inactive
  • bit 1 – Anti-virus application is installed but real-time protection is not running
  • bit 2 – Anti-virus application is installed but not running
  • bit 3 – Number of viruses detected is too much
  • bit 4 – Anti-virus application is installed but real-time protection status differs from one set by the security administrator
  • bit 5 – Anti-virus application is not installed
  • bit 6 – Full scan for viruses performed too long ago
  • bit 7 – Anti-virus bases were updated too long ago
  • bit 8 – Network agent is inactive too long
  • bit 9 – Old license (supported by Administration Server 7.0 or higher)
  • bit 10 – Number of uncured objects is too much (supported by Administration Server 7.0 or higher)
  • bit 11 – Reboot is required
  • bit 12 – One or more incompatible applications are installed on the host
  • bit 13 - Host has one or more vulnerabilities
  • bit 14 - Last search for updates has been performed too long ago on the host
  • bit 15 - The host does not have proper encryption status
  • bit 16 - Mobile device settings does not meet requirements of the security policy

Read-only
"HST_HAS_UPDATE_AGENT" Boolean Host has update agent Read-only
"KLHST_WKS_NAG_VERSION" String Network agent build number in format A.B.C[.D] Read-only
"KLHST_WKS_RTP_AV_VERSION" String Protection build number in format A.B.C[.D] Read-only
"KLHST_WKS_RTP_AV_BASES_TIME" Time Anti-virus bases time Read-only
"KLHST_WKS_LAST_SYSTEM_START" Time Last system start time Read-only
"KLHST_WKS_RBT_REQUIRED" Boolean If reboot is required Read-only
"KLHST_WKS_RBT_REQUEST_REASON" Integer Reboot request reasons mask, bit set:
  • bit 0 - Reason is unspecified
  • bit 1 - Application is unusable until reboot
  • bit 2 - Application is usable but reboot is required to complete update process
  • bit 3 - Reboot is required to initiate update process
  • bit 4 - Reboot is required to complete scanning/curing
  • bit 5 - Reboot is required to complete installation/uninstallation
Read-only
"KLHST_WKS_RBT_REQUEST_TIME" Time Reboot request time Read-only
"KLHST_APP_INFO" IKlAkParams

Info about products installed on the host. Has following format

	"KLHST_APP_INFO"
	|
	+--<product>, type IKlAkParams
		|
		+--<version>, type IKlAkParams
			|
			+--"KLHST_APP_STATE", type Integer
			|
			+--"KLHST_APP_STATE_TIME", type Time

Where

Read-only, may be used in IKlAkHosts.GetHostInfo method only