Source code of Windows XP (NT5)
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
|
|
// 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.
//
// Copyright (C) 1993-1995 Microsoft Corporation. All Rights Reserved.
//
// MODULE: service.h
//
// AUTHOR: Craig Link
//
//
// Comments: The use of this header file and the accompanying service.c
// file simplifies the process of writting a service. You as a developer
// simply need to follow the TODO's outlined in this header file, and
// implement the ServiceStart() and ServiceStop() functions.
//
// There is no need to modify the code in service.c. Just add service.c
// to your project and link with the following libraries...
//
// libcmt.lib kernel32.lib advapi.lib shell32.lib
//
// This code also supports unicode. Be sure to compile both service.c and
// and code #include "service.h" with the same Unicode setting.
//
// Upon completion, your code will have the following command line interface
//
// <service exe> -? to display this list
// <service exe> -install to install the service
// <service exe> -remove to remove the service
// <service exe> -debug <params> to run as a console app for debugging
//
// Note: This code also implements Ctrl+C and Ctrl+Break handlers
// when using the debug option. These console events cause
// your ServiceStop routine to be called
//
// Also, this code only handles the OWN_SERVICE service type
// running in the LOCAL_SYSTEM security context.
//
// To control your service ( start, stop, etc ) you may use the
// Services control panel applet or the NET.EXE program.
//
// To aid in writing/debugging service, the
// SDK contains a utility (MSTOOLS\BIN\SC.EXE) that
// can be used to control, configure, or obtain service status.
// SC displays complete status for any service/driver
// in the service database, and allows any of the configuration
// parameters to be easily changed at the command line.
// For more information on SC.EXE, type SC at the command line.
//
#ifndef _SERVICE_H
#define _SERVICE_H
#ifdef __cplusplus
extern "C" {#endif
//////////////////////////////////////////////////////////////////////////////
//// todo: change to desired strings
////
// name of the executable
#define SZAPPNAME L"cryptsvc"
// internal name of the service
#define SZSERVICENAME L"CryptSvc"
// displayed name of the service
#define SZSERVICEDISPLAYNAME L"Cryptographic Services"
#define SZSERVICEDISPLAYNAMEA "Cryptographic Services"
// list of service dependencies - "dep1\0dep2\0\0"
// RPC must be running for us to work!
#define SZDEPENDENCIES L"RpcSs\0" // doubly null terminated
//////////////////////////////////////////////////////////////////////////////
//////////////////////////////////////////////////////////////////////////////
//// todo: ServiceStart()must be defined by in your code.
//// The service should use ReportStatusToSCMgr to indicate
//// progress. This routine must also be used by StartService()
//// to report to the SCM when the service is running.
////
//// If a ServiceStop procedure is going to take longer than
//// 3 seconds to execute, it should spawn a thread to
//// execute the stop code, and return. Otherwise, the
//// ServiceControlManager will believe that the service has
//// stopped responding
////
DWORD ServiceStart (HINSTANCE hInstance, int nCmdShow);VOID ServiceStop();//////////////////////////////////////////////////////////////////////////////
//////////////////////////////////////////////////////////////////////////////
//// The following are procedures which
//// may be useful to call within the above procedures,
//// but require no implementation by the user.
//// They are implemented in service.c
//
// FUNCTION: ReportStatusToSCMgr()
//
// PURPOSE: Sets the current status of the service and
// reports it to the Service Control Manager
//
// PARAMETERS:
// dwCurrentState - the state of the service
// dwWin32ExitCode - error code to report
// dwWaitHint - worst case estimate to next checkpoint
//
// RETURN VALUE:
// TRUE - success
// FALSE - failure
//
BOOL ReportStatusToSCMgr(DWORD dwCurrentState, DWORD dwWin32ExitCode, DWORD dwWaitHint);
//
// FUNCTION: AddToMessageLog(LPWSTR lpszMsg)
//
// PURPOSE: Allows any thread to log an error message
//
// PARAMETERS:
// lpszMsg - text for message
//
// RETURN VALUE:
// none
//
void AddToMessageLog(LPWSTR lpszMsg);//////////////////////////////////////////////////////////////////////////////
void StopRPCServer();
// entry point to start the service from install stub.
DWORD WINAPI Start( LPVOID lpV );
#ifdef __cplusplus
}#endif
#endif
|
