3.2.5.1 Obtain Management Agent Object

In order to interact with Synchronization Management Objects, the client MUST obtain a Management Agent object by executing an ExecQuery command on the Service object using the ExecQuery method with the following parameters:

Query: "MIIS_ManagementAgent.Name = <name of management agent>"

where <name of management agent> is the name of the management agent against which the client intends to operate.

If the client does not have permission required to execute a method, the server MUST return the literal string "access-denied"<2>. If the management agent name does not correspond to an existing management agent, the server MUST return NULL. Otherwise, the server MUST return a management agent object which supports the methods listed in 3.2.5.2 through 3.2.5.29.