d40707a134
git-svn-id: svn://10.65.10.50/branches/R_10_00@23098 c028cbd2-c16b-5b4b-a496-9718f37d4682
79 lines
2.9 KiB
C
79 lines
2.9 KiB
C
/****************************** Module Header ******************************\
|
|
* Module Name: ServiceInstaller.h
|
|
* Project: CppWindowsService
|
|
* Copyright (c) Microsoft Corporation.
|
|
*
|
|
* The file declares functions that install and uninstall the service.
|
|
*
|
|
* This source is subject to the Microsoft Public License.
|
|
* See http://www.microsoft.com/en-us/openness/resources/licenses.aspx#MPL.
|
|
* All other rights reserved.
|
|
*
|
|
* THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
|
|
* EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED
|
|
* WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR PURPOSE.
|
|
\***************************************************************************/
|
|
|
|
#pragma once
|
|
|
|
|
|
//
|
|
// FUNCTION: InstallService
|
|
//
|
|
// PURPOSE: Install the current application as a service to the local
|
|
// service control manager database.
|
|
//
|
|
// PARAMETERS:
|
|
// * pszServiceName - the name of the service to be installed
|
|
// * pszDisplayName - the display name of the service
|
|
// * dwStartType - the service start option. This parameter can be one of
|
|
// the following values: SERVICE_AUTO_START, SERVICE_BOOT_START,
|
|
// SERVICE_DEMAND_START, SERVICE_DISABLED, SERVICE_SYSTEM_START.
|
|
// * pszDependencies - a pointer to a double null-terminated array of null-
|
|
// separated names of services or load ordering groups that the system
|
|
// must start before this service.
|
|
// * pszAccount - the name of the account under which the service runs.
|
|
// * pszPassword - the password to the account name.
|
|
//
|
|
// NOTE: If the function fails to install the service, it prints the error
|
|
// in the standard output stream for users to diagnose the problem.
|
|
//
|
|
bool InstallService(LPCTSTR pszServiceName,
|
|
LPCTSTR pszDisplayName,
|
|
DWORD dwServiceType,
|
|
DWORD dwStartType,
|
|
LPCTSTR pszDependencies,
|
|
LPCTSTR pszAccount,
|
|
LPCTSTR pszPassword);
|
|
|
|
|
|
//
|
|
// FUNCTION: UninstallService
|
|
//
|
|
// PURPOSE: Stop and remove the service from the local service control
|
|
// manager database.
|
|
//
|
|
// PARAMETERS:
|
|
// * pszServiceName - the name of the service to be removed.
|
|
//
|
|
// NOTE: If the function fails to uninstall the service, it prints the
|
|
// error in the standard output stream for users to diagnose the problem.
|
|
//
|
|
bool UninstallService(PWSTR pszServiceName);
|
|
|
|
|
|
//
|
|
// FUNCTION: StartStopService
|
|
//
|
|
// PURPOSE: Starts or Stops the service
|
|
//
|
|
// PARAMETERS:
|
|
// * pszServiceName - the name of the service to be started or stopped.
|
|
// bStart - TRUE to start or FALSE to stop
|
|
//
|
|
// NOTE: If the function fails to uninstall the service, it prints the
|
|
// error in the standard output stream for users to diagnose the problem.
|
|
//
|
|
bool StartService(PWSTR pszServiceName);
|
|
bool StopService(PWSTR pszServiceName);
|