| OBEX D-Bus Agent API description |
| ******************************** |
| |
| |
| Agent Manager hierarchy |
| ======================= |
| |
| Service org.bluez.obex |
| Interface org.bluez.obex.AgentManager1 |
| Object path /org/bluez/obex |
| |
| Methods void RegisterAgent(object agent) |
| |
| Register an agent to request authorization of |
| the user to accept/reject objects. Object push |
| service needs to authorize each received object. |
| |
| Possible errors: org.bluez.obex.Error.AlreadyExists |
| |
| void UnregisterAgent(object agent) |
| |
| This unregisters the agent that has been previously |
| registered. The object path parameter must match the |
| same value that has been used on registration. |
| |
| Possible errors: org.bluez.obex.Error.DoesNotExist |
| |
| |
| Agent hierarchy |
| =============== |
| |
| Service unique name |
| Interface org.bluez.obex.Agent1 |
| Object path freely definable |
| |
| Methods void Release() |
| |
| This method gets called when the service daemon |
| unregisters the agent. An agent can use it to do |
| cleanup tasks. There is no need to unregister the |
| agent, because when this method gets called it has |
| already been unregistered. |
| |
| string AuthorizePush(object transfer) |
| |
| This method gets called when the service daemon |
| needs to accept/reject a Bluetooth object push request. |
| |
| Returns the full path (including the filename) where |
| the object shall be stored. The tranfer object will |
| contain a Filename property that contains the default |
| location and name that can be returned. |
| |
| Possible errors: org.bluez.obex.Error.Rejected |
| org.bluez.obex.Error.Canceled |
| |
| void Cancel() |
| |
| This method gets called to indicate that the agent |
| request failed before a reply was returned. It cancels |
| the previous request. |
