KSC Open API
Kaspersky Security Center API description
ChangeState
GetState
MakeupContextForResponse
RelationAdd
RelationRemove
RelationUpdateControllers
RelationUpdatePassword
RspAdUaRelation::RelationUpdateControllers ( wstring  wstrUaHostId,
wstring  wstrAdDomain,
array  pDomainConrollers,
int  nOperation 
)

Change domain controllers list.

Changes domain contollers list for the relation.

To list current controllers use SrvView Relation between Active Directory domain controllers and Update Agents

Parameters:
wstrUaHostIdGUID host name of the UA or empty string for Administration Server's Network Agent
wstrAdDomainActive Directory domain name in lowercase FQDN format, e.g. "mycompany.com"
pDomainConrollersnon-empty array of strings, each of string is a domain controller address (it may be either DNS name or NetBIOS name or IP address)
nOperationoperation type:
  • c_nOP_AddControllers (1) means add controllers listed in pDomainConrollers (duplicates are ignored)
  • c_nOP_ReplaceControllers (2) means replace controllers listed in pDomainConrollers
  • c_nOP_RemoveControllers (3) means delete controllers listed in pDomainConrollers (inexisting ones are skipped)
Note:
if wstrUaHostId is empty then current session must target the physical server otherwise exception STDE_NOTPERM is thrown.
Deleting the last controller results in deleting the relation itself.
Exceptions:
STDE_NOTPERMOperation is prohibited (e.g. wstrUaHostId does not have UA role, or an attempt to access physical server in context of virtual one, or this feature is disabled)