WINDOWS NT SERVICES

==> SOMMAIRE *******************************************************************

    1. DESCRIPTION
    2. IMPLEMENTATION DE SERVICES
    3. CONTROLE DE SERVICES
    4. CONTACT


==> 1. DESCRIPTION ****************************************************************

    > IMPLEMENTATION DE SERVICES
    
    * Encapsulation quasi complète de l'API windows de services
    * full customization via callback
    * embeddable dans une Dll
    * full logging support (via Windows events logs)
    * convertit toute application C/C++ en service Windows NT

    > CONTROLE DE SERVICES

    * installation, modification, suppression
    * start, stop, pause, redémarrage de service
    * vérification du status d'un service
    * listage de services
    * Informations complètes sur un service
    * gestion des dépendances
    * gestions des services sur des machines distantes

    > MISC.

    * ansi / unicode support

==> 2. SERVICE IMPLEMENTATION *************************************************

Pour implémenter un service, il suffit juste de fournir une fonction de traitement !

Exemple :


#include <NTService.h>

void WINAPI MyServiceMain()
{
    while (!ServiceIsTerminated())
    {
        if (ServiceGetCurrentStatus() == SERVICE_RUNNING)
        {
            /* code application */
            /* ... */	
        }
        
        ServiceSleep(1000);			
    }
}

int main(int argc, char** argv)
{
    return ServiceRun("MyServiceName", MyServiceMain, 1000, SERVICE_ACCEPT_STOP);
}

Pour plus de contrôle et/ou information sur le service et ses évènements, il est possible de fournir une fonction callback

Exemple :

DWORD WINAPI MyServiceCallback(DWORD dwEvent, DWORD dwState)
{
    switch (dwEvent)
    {
        case SE_INSTALL: 
            if (dwState == SS_SUCCESS)
                ServiceLog(EVENTLOG_INFORMATION_TYPE, _T("Installation ok"));
            break;
        case SE_DELETE: 
            if (dwState == SS_SUCCESS)
                ServiceLog(EVENTLOG_INFORMATION_TYPE, _T("Uninstallation ok"));
            break;
        case SE_START: 
            /*...*/
            break;
        case SE_STOP: 
            /*...*/
            break;
        case SE_PAUSE:
            /*...*/
            break;
        case SE_CONTINUE:
            /*...*/
            break;
        case SE_CUSTOM: 
            return ServiceLog(EVENTLOG_INFORMATION_TYPE,  _T("Event %s - Status %s"), dwEvent, dwState);
    }
    
    return SS_SUCCESS;
}

Pour utiliser le logging par défaut dans le journal système de windows, il faut inclure les fichiers NTEventLog.xxx à votre projet

==> 3. IMPLEMENTATION DE SERVICES ********************************************************

La librarie fournit toute les fonctions nécessaires pour contrôler des services en local ou distants.

Exemple pour lister les services en local :

LPSERVICE_ITEM list = LocalServiceGetList(SERVICE_WIN32, SERVICE_STATE_ALL, &count);

for (i = 0; i < count; i++) 
{
    printf(list[i].lpDisplayName);
    printf(list[i].lpServiceName);
 
    LPSERVICE_INFO info = LocalServiceGetInfo();
	
    if (info)
    {
        printf(info->lpBinaryPathName);
        printf(info->lpDescription);
        printf(info->lpServiceStartName);

        ServiceFreePointer(info);
    }
}

==> 4. CONTACT ****************************************************************

Pour toute remarque, commentaire, bug, contactez moi :

vince_rogier@yahoo.fr


Have fun !!!