На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

Writing a ServiceMain Function



The MyServiceStart function in the following example is the entry point for the service. MyServiceStart has access to the command-line arguments, in the way that the main function of a console application does. The first parameter contains the number of arguments being passed to the service. There will always be at least one argument. The second parameter is a pointer to an array of string pointers. The first item in the array always points to the service name.

The MyServiceStart function first fills in the SERVICE_STATUS structure including the control codes that it accepts. Although this service accepts SERVICE_CONTROL_PAUSE and SERVICE_CONTROL_CONTINUE, it does nothing significant when told to pause. The flags SERVICE_ACCEPT_PAUSE_CONTINUE was included for illustration purposes only; if pausing does not add value to your service, do not support it.
The MyServiceStart function then calls the RegisterServiceCtrlHandler function to register MyService as the service's Handler function and begin initialization. The following sample initialization function, MyServiceInitialization, is included for illustration purposes; it does not perform any initialization tasks such as creating additional threads. If your service's initialization performs tasks that are expected to take longer than one second, your code must call the SetServiceStatus function periodically to send out wait hints and check points indicating that progress is being made.

When initialization has completed successfully, the example calls SetServiceStatus with a status of SERVICE_RUNNING and the service continues with its work. If an error has occurred in initialization, MyServiceStart reports SERVICE_STOPPED with the SetServiceStatus function and returns.
Because this sample service does not complete any real tasks, MyServiceStart simply returns control to the caller. However, your service should use this thread to complete whatever tasks it was designed to do. If a service does not need a thread to do its work (such as a service that only processes RPC requests), its ServiceMain function should return control to the caller. It is important for the function to return, rather than call the ExitThread function, because returning allows for cleanup of the memory allocated for the arguments.

To output debugging information, MyServiceStart calls SvcDebugOut. The source code for SvcDebugOut is given in Writing a Service Program's main Function.

void MyServiceStart (DWORD argc, LPTSTR *argv)
{
DWORD status;
DWORD specificError;

MyServiceStatus.dwServiceType = SERVICE_WIN32;
MyServiceStatus.dwCurrentState = SERVICE_START_PENDING;
MyServiceStatus.dwControlsAccepted = SERVICE_ACCEPT_STOP |
SERVICE_ACCEPT_PAUSE_CONTINUE;
MyServiceStatus.dwWin32ExitCode = 0;
MyServiceStatus.dwServiceSpecificExitCode = 0;
MyServiceStatus.dwCheckPoint = 0;

MyServiceStatus.dwWaitHint = 0;

MyServiceStatusHandle = RegisterServiceCtrlHandler(
TEXT("MyService"),
MyServiceCtrlHandler);

if (MyServiceStatusHandle == (SERVICE_STATUS_HANDLE)0)
{
SvcDebugOut(" [MY_SERVICE] RegisterServiceCtrlHandler
failed %d\n", GetLastError());
return;
}

// Initialization code goes here.
status = MyServiceInitialization(argc,argv, &specificError);


// Handle error condition
if (status != NO_ERROR)
{
MyServiceStatus.dwCurrentState = SERVICE_STOPPED;
MyServiceStatus.dwCheckPoint = 0;
MyServiceStatus.dwWaitHint = 0;
MyServiceStatus.dwWin32ExitCode = status;
MyServiceStatus.dwServiceSpecificExitCode = specificError;

SetServiceStatus (MyServiceStatusHandle, &MyServiceStatus);
return;
}

// Initialization complete - report running status.

MyServiceStatus.dwCurrentState = SERVICE_RUNNING;
MyServiceStatus.dwCheckPoint = 0;
MyServiceStatus.dwWaitHint = 0;

if (!SetServiceStatus (MyServiceStatusHandle, &MyServiceStatus))
{
status = GetLastError();
SvcDebugOut(" [MY_SERVICE] SetServiceStatus error
%ld\n",status);
}

// This is where the service does its work.
SvcDebugOut(" [MY_SERVICE] Returning the Main Thread \n",0);


return;
}

// Stub initialization function.
DWORD MyServiceInitialization(DWORD argc, LPTSTR *argv,
DWORD *specificError)
{
argv;
argc;
specificError;
return(0);
}



Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

Сочинение Функции ServiceMain



Функция MyServiceStart в следующем примере - точка входа для услуги. MyServiceStart ИМЕЕТ доступ к командной линии аргументов, в пути, что основная функция консольного приложения делает. Первый параметр содержит количество аргументов, прохоженных в услугу. Там всегда быть по крайней мере одним аргументом. Второй параметр является указателем в массив указателей строки. Первый пункт в массиве всегда указывает на имя услуги.

Функция MyServiceStart сначала заполняет структуру SERVICE_STATUS включая управление кодирует, что оно принимает. Хотя эта услуга принимает SERVICE_CONTROL_PAUSE и SERVICE_CONTROL_CONTINUE, она делает ничто значимым когда сообщено, чтобы останавливаться. Флаги SERVICE_ACCEPT_PAUSE_CONTINUE были включены для целей иллюстрации только; если пауза не добавляет величину к вашей услуге, не поддерживает это.
Функция MyServiceStart затем называет функцию RegisterServiceCtrlHandler, чтобы регистрировать MyService как Вручителя услуги функционировать и начинать инициализацию. Функция инициализации следующего образца, MyServiceInitialization, включена для целей иллюстрации; это не выполняет любые задачи инициализации как например, дополнительная резьба создания. Если ваша инициализация услуги выполняет задачи, которые ожидается, что потребоваться дольше чем один секунда, ваш код должен назвать функцию SetServiceStatus периодически, чтобы посылать намеки ожидания и проверять точки, указывающие, что прогресс сделан.

Когда инициализация завершилась успешно, вызовы примера SetServiceStatus со статусом SERVICE_RUNNING и услуга продолжает свою работу. Если ошибка произошла бы в инициализации, сообщениях MyServiceStart SERVICE_STOPPED с функцией SetServiceStatus и возврат.
Поскольку эта услуга образца не завершает любые реальные задачи, управление просто возврата MyServiceStart вызывающему оператору. Тем не менее, ваша услуга должна использовать эту резьбу, чтобы завершать независимо от того какие задачи, которые она была предназначена делать. Если услуга не нужно резьба, чтобы делать своей работой (как например, услуга, которая только обрабатывает просьбы RPC), функция ServiceMain должна возвращать управление вызывающему оператору. Важно для функции возвращать, а не называть функцию ExitThread, поскольку возврат учитывает очистку памяти распределенной для аргументов.

В выход отладочную информацию, вызовы MyServiceStart SvcDebugOut. Исходный код для SvcDebugOut дается в письменной форме Программная основная Функция Услуги.

пустота MyServiceStart (DWORD argc, LPTSTR *argv)
{
СТАТУС DWORD;
specificError DWORD;

MyServiceStatus.dwServiceType = SERVICE_WIN32;
MyServiceStatus.dwCurrentState = SERVICE_START_PENDING;
MyServiceStatus.dwControlsAccepted = SERVICE_ACCEPT_STOP | SERVICE_ACCEPT_PAUSE_CONTINUE;
MyServiceStatus.dwWin32ExitCode = 0;
MyServiceStatus.dwServiceSpecificExitCode = 0;
MyServiceStatus.dwCheckPoint = 0;

MyServiceStatus.dwWaitHint = 0;

MyServiceStatusHandle = RegisterServiceCtrlHandler( ТЕКСТ("MyService"), MyServiceCtrlHandler);

если (MyServiceStatusHandle == (SERVICE_STATUS_HANDLE)0)
{
SvcDebugOut(" [MY_SERVICE] RegisterServiceCtrlHandler ПОТЕРПЕВШЕЕ неудачу %d\n", GetLastError());
возврат;
}

// Код Инициализации идет сюда.
статус = MyServiceInitialization(argc,argv, &specificError);


// Условие ошибки Ручки если (статус != NO_ERROR)
{
MyServiceStatus.dwCurrentState = SERVICE_STOPPED;
MyServiceStatus.dwCheckPoint = 0;
MyServiceStatus.dwWaitHint = 0;
MyServiceStatus.dwWin32ExitCode = статус;
MyServiceStatus.dwServiceSpecificExitCode = specificError;

SetServiceStatus (MyServiceStatusHandle, &MyServiceStatus);
возврат;
}

// Завершать Инициализации - сообщает прогон статуса.

MyServiceStatus.dwCurrentState = SERVICE_RUNNING;
MyServiceStatus.dwCheckPoint = 0;
MyServiceStatus.dwWaitHint = 0;

если (!SetServiceStatus (MyServiceStatusHandle, &MyServiceStatus))
{
статус = GetLastError();
SvcDebugOut(" [MY_SERVICE] ОШИБКА SetServiceStatus %ld\n",статус);
}

// Это - где услуга делает своей работой.
SvcDebugOut(" [MY_SERVICE] ВОЗВРАЩАВ Основную Резьбу \n",0);


возврат;
}

// Функция инициализации Заглушки.
DWORD MyServiceInitialization(DWORD argc, LPTSTR *argv, DWORD *specificError)
{
argv;
argc;
specificError;
возвращать(0);
}



Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz