Kaspersky Security Center Automation  10.0
HRESULT IKlAkUpdateAgents::RegisterUpdateAgent ( [in] IKlAkParams pInfo,
[in] VARIANT_BOOL  bForceRecreate,
[out, retval] VARIANT_BOOL *  pbCreated 
)

Register Update agent.

Register specified host as update agent.

Parameters:
pInfo Container with Network Agent attribute (see List of update agent attributes). Following attributes are required.
  • "hosname"
  • "dn"
  • "groupid"
bForceRecreate force registering. If bForceRecreate is false and specified host is already registered as update agent methods will return false and nothing will be done. If bForceRecreate is true specified host will be registered as update agent even if it is already registered.
Return values:
pbCreated true if Update agent was really registered

The method failes if automatic update agents are enabled. To turn off automatic update agents set "UseAutomaticUAs" property to false. IKlAkUpdateAgents.Prop("UseAutomaticUAs") = 0;

See also Registering update agents for hosts in group sample and Enumerating all groups sample.