https://github.com/flowerinthenight/base-atlcom-svc

Skeleton ATL COM Windows service.
https://github.com/flowerinthenight/base-atlcom-svc

atl com cpp windows-service

Last synced: about 1 month ago
JSON representation

Skeleton ATL COM Windows service.

• Host: GitHub
• URL: https://github.com/flowerinthenight/base-atlcom-svc
• Owner: flowerinthenight
• License: mit
• Created: 2017-01-15T02:17:40.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2017-01-15T21:17:44.000Z (almost 8 years ago)
• Last Synced: 2023-10-20T19:52:11.164Z (about 1 year ago)
• Topics: atl, com, cpp, windows-service
• Language: C
• Size: 70.3 KB
• Stars: 1
• Watchers: 3
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
[![Build status](https://ci.appveyor.com/api/projects/status/0ivg77ha322fam9u/branch/master?svg=true)](https://ci.appveyor.com/project/flowerinthenight/base-atlcom-svc/branch/master)

# Overview

Skeleton code for an ATL-based Windows service. Basically the same as a [traditional Windows service](https://github.com/flowerinthenight/win32-base-service) but with some advantages.

* Can be started on-demand automatically by the first client call (via COM).

* Clients can call service functions with parameters and return values using COM. In traditional services, clients normally communicate using service control codes and you need some kind of IPC (named pipes, shared memory, etc.) for bi-directional data exchange.

### Installation

Run the following in an elevated command prompt.

```

BaseAtlComSvc.exe /service

```

This will install the service with a "Manual" startup type. You can start the service manually or by command prompt or from a client app.

### Using the test client

A client console app is provided to test the service. After the service is installed, run `testclient.exe` without arguments. This will query the service version (which is hardcoded to 1.0.0). The call will cause the service to start automatically (when it's not yet started).

### Testing service notification

The service can also notify clients of events via IDispatch. To test, run `testclient.exe event`. The client will send a value to the service and in return, the service will notify the client of the received value. The call will also cause the service to start automatically (when it's not yet started).

### Uninstallation

```

BaseAtlComSvc.exe /unregserver

```

### ETW trace

This project uses the ETW setup [here](https://github.com/flowerinthenight/win32-etw-manifest).

# License

[The MIT License](./LICENSE.md)