/vp_plugins/qtservice-2.6_1-opensource/examples/controller/controller.qdoc

http://cupsfilter.googlecode.com/ · Unknown · 81 lines · 75 code · 6 blank · 0 comment · 0 complexity · 2613978ead0abf71ac61805c7ab20729 MD5 · raw file

  1. /****************************************************************************
  2. **
  3. ** Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
  4. ** All rights reserved.
  5. ** Contact: Nokia Corporation (qt-info@nokia.com)
  6. **
  7. ** This file is part of a Qt Solutions component.
  8. **
  9. ** Commercial Usage
  10. ** Licensees holding valid Qt Commercial licenses may use this file in
  11. ** accordance with the Qt Solutions Commercial License Agreement provided
  12. ** with the Software or, alternatively, in accordance with the terms
  13. ** contained in a written agreement between you and Nokia.
  14. **
  15. ** GNU Lesser General Public License Usage
  16. ** Alternatively, this file may be used under the terms of the GNU Lesser
  17. ** General Public License version 2.1 as published by the Free Software
  18. ** Foundation and appearing in the file LICENSE.LGPL included in the
  19. ** packaging of this file. Please review the following information to
  20. ** ensure the GNU Lesser General Public License version 2.1 requirements
  21. ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
  22. **
  23. ** In addition, as a special exception, Nokia gives you certain
  24. ** additional rights. These rights are described in the Nokia Qt LGPL
  25. ** Exception version 1.1, included in the file LGPL_EXCEPTION.txt in this
  26. ** package.
  27. **
  28. ** GNU General Public License Usage
  29. ** Alternatively, this file may be used under the terms of the GNU
  30. ** General Public License version 3.0 as published by the Free Software
  31. ** Foundation and appearing in the file LICENSE.GPL included in the
  32. ** packaging of this file. Please review the following information to
  33. ** ensure the GNU General Public License version 3.0 requirements will be
  34. ** met: http://www.gnu.org/copyleft/gpl.html.
  35. **
  36. ** Please note Third Party Software included with Qt Solutions may impose
  37. ** additional restrictions and it is the user's responsibility to ensure
  38. ** that they have met the licensing requirements of the GPL, LGPL, or Qt
  39. ** Solutions Commercial license and the relevant license of the Third
  40. ** Party Software they are using.
  41. **
  42. ** If you are unsure which license is appropriate for your use, please
  43. ** contact Nokia at qt-info@nokia.com.
  44. **
  45. ****************************************************************************/
  46. /*! \page qtservice-example-controller.html
  47. \title A simple Service Controller
  48. It is a very simple implementation of universal command-line
  49. controller. This controller can install and control any service
  50. written using QtService component. It demonstrates how to use
  51. QtServiceController class. On Windows, this is an alternative to
  52. using the "Services" Administrative Tool or the built-in \c sc.exe
  53. command-line tool to control services.
  54. A note about services on Windows Vista: Installing/uninstalling
  55. and starting/stopping services requires security privileges. The
  56. simplest way to achieve this is to set the "Run as Administrator"
  57. property on the executable (right-click the executable file,
  58. select Properties, and choose the Compatibilty tab in the
  59. Properties dialog). This applies even if you are logged in as
  60. Administrator. Also, the command-line shell should be started with
  61. "Run as Administrator". Note that the service itself does not need
  62. special privileges to run. Only if you want the service to be able
  63. to install itself (the -i option) or similar, then the service
  64. will need to be run as Administrator. Otherwise, the recommended
  65. procedure is to use a controller such as this example and/or the
  66. "Services" Administrative Tool to manage the service.
  67. A usability hint: in some circumstances, e.g. when running this
  68. example on Windows Vista with the "Run as Administrator" property
  69. set, output will be sent to a shell window which will close
  70. immediately upon termination, not leaving the user enough time to
  71. read the output. In such cases, append the -w(ait) argument, which
  72. will make the controller wait for a keypress before terminating.
  73. Here is the complete source code:
  74. \quotefile controller/main.cpp
  75. */