https://github.com/ntoskrnl7/win32-ex
Win32 API Experimental(or Extension) features
https://github.com/ntoskrnl7/win32-ex
c cpp cpp98-compatible easy-to-use experimental experimental-project header-only kernel32 modern-cpp system system-programming vs2008 vs2010 win32 win32api windows windows-desktop
Last synced: about 6 hours ago
JSON representation
Win32 API Experimental(or Extension) features
- Host: GitHub
- URL: https://github.com/ntoskrnl7/win32-ex
- Owner: ntoskrnl7
- License: mit
- Created: 2021-03-31T07:01:45.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2022-11-18T03:46:31.000Z (over 3 years ago)
- Last Synced: 2023-03-03T19:58:18.117Z (over 3 years ago)
- Topics: c, cpp, cpp98-compatible, easy-to-use, experimental, experimental-project, header-only, kernel32, modern-cpp, system, system-programming, vs2008, vs2010, win32, win32api, windows, windows-desktop
- Language: C++
- Homepage:
- Size: 381 KB
- Stars: 28
- Watchers: 3
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Win32Ex
Win32 API Experimental(or Extension) features.
[](https://github.com/ntoskrnl7/win32-ex/actions/workflows/cmake.yml)
[](https://github.com/ntoskrnl7/win32-ex/actions/workflows/msys2.yml)
It is a library that helps to more easily implement tasks such as service program creation and process creation for each user account in Windows environment.
It is implemented with outdated syntax and features because it is also designed for use in legacy development environments (Visual Studio 2008 SP1).
---
## Requirements
- Windows 8 or later
- Visual Studio 2008 SP1 or later
- MSYS2
- MSYS
- MinGW 32-bit
- MinGW 64-bit
- MinGW Clang 32-bit
- MinGW Clang 64-bit
- MinGW UCRT 64-bit
---
## Test Environments
- Windows 10
- MSYS2
- MSYS
- MinGW 32-bit
- MinGW 64-bit
- MinGW Clang 32-bit
- MinGW Clang 64-bit
- MinGW UCRT 64-bit
- Visual Studio
- 2008 SP1
- 2010, 2012, 2017, 2019, 2022
---
## Contents
- [Win32Ex](#win32ex)
- [Requirements](#requirements)
- [Test Environments](#test-environments)
- [Contents](#contents)
- [Features](#features)
- [System Services](#system-services)
- [Processes and Threads](#processes-and-threads)
- [Remote Desktop Services](#remote-desktop-services)
- [Services](#services)
- [Windows System Information](#windows-system-information)
- [Handles and Objects](#handles-and-objects)
- [Security and Identity](#security-and-identity)
- [Privileges](#privileges)
- [Access Tokens](#access-tokens)
- [Security Descriptors](#security-descriptors)
- [Security Identifiers](#security-identifiers)
- [Etc](#etc)
- [Optional](#optional)
- [Result](#result)
- [Win32 API Template](#win32-api-template)
- [Test](#test)
- [CMake](#cmake)
- [Usage](#usage)
- [CMakeLists.txt](#cmakeliststxt)
- [test.cpp](#testcpp)
---
## Features
- **Headers :** Win32Ex.h
### System Services
- **Headers :** Win32Ex/System.h
- [More](docs/system-services.md)
#### Processes and Threads
- **Headers :** Win32Ex/System/Process.h, Win32Ex/System/Process.hpp
- [More](docs/procthread.md)
#### Remote Desktop Services
- **Headers :** Win32Ex/System/Session.hpp
- [More](docs/termserv.md)
#### Services
- **Headers :** Win32Ex/System/Service.hpp
- [More](docs/services.md)
#### Windows System Information
- [More](docs/sysinfo.md)
##### Handles and Objects
- **Headers :** Win32Ex/System/Object.h
- [More](docs/sysinfo/handles-and-objects.md)
### Security and Identity
- **Headers :** Win32Ex/Security.h
- [More](docs/secauthz.md)
#### Privileges
- **Headers :** Win32Ex/Security/Privilege.h, Win32Ex/Security/Privilege.hpp
- [More](docs/secauthz/privileges.md)
#### Access Tokens
- **Headers :** Win32Ex/Security/Token.h, Win32Ex/Security/Token.hpp
- [More](docs/secauthz/access-tokens.md)
#### Security Descriptors
- **Headers :** Win32Ex/Security/Descriptor.h
- [More](docs/secauthz/security-descriptors.md)
#### Security Identifiers
- **Headers :** Security\Sid.h
- [More](docs/secauthz/security-identifiers.md)
### Etc
- [More](docs/etc.md)
#### Optional
- **Headers :** Win32Ex/Optional.hpp
- [More](docs/etc/optional.md)
#### Result
- **Headers :** Win32Ex/Result.hpp
- [More](docs/etc/result.md)
#### Win32 API Template
- [More](docs/etc/api-tmpl.md)
---
## Test
### CMake
- With MSYS2
```bash
cd test
mkdir build && cd build
if [ "$MSYSTEM" = "MSYS" ]; then
cmake ..
else
cmake -G "MinGW Makefiles" ..
fi
cmake --build .
if [ "$?" -eq 0 ]; then
export LC_ALL=C; unset LANGUAGE
ctest . --verbose
fi
```
- With Visual Studio
```batch
cd test
mkdir build
cd build
cmake ..
cmake --build . -- /p:CharacterSet=Unicode
if errorlevel 0 ctest . --verbose -C Debug
```
## Usage
*We usually recommend using CMake. However, if you are using Visual Studio directly, add **{This repository}/include** to the '**[Additional Include Directories](https://docs.microsoft.com/cpp/build/reference/i-additional-include-directories#to-set-this-compiler-option-in-the-visual-studio-development-environment
)** property'.*
### CMakeLists.txt
```cmake
cmake_minimum_required(VERSION 3.14 FATAL_ERROR)
# create project
project(MyProject)
# add executable
add_executable(tests tests.cpp)
# add dependencies
include(cmake/CPM.cmake)
CPMAddPackage("gh:ntoskrnl7/win32-ex@0.8.23")
# link dependencies
target_link_libraries(tests win32ex)
```
### test.cpp
```C++
#include
#include
#include
// or #include
// or #include
Win32Ex::System::Service SimpleService("SimpleSvc");
int main()
{
std::cout << Win32Ex::System::Process::All().size();
Win32Ex::System::Service::Instance::Get()
.OnStart([]() {
// TODO
})
.OnStop([]() {
// TODO
})
.OnPause([]() {
// TODO
})
.OnContinue([]() {
// TODO
})
.OnError([](DWORD ErrorCode, PCSTR Message) {
// TODO
})
.Run();
return 0;
}
```