windows.h
 | This article needs additional citations for verification. (April 2017) |
windows.h is a source code header file that Microsoft provides for the development of programs that access the Windows API (WinAPI) via C language syntax. It declares the WinAPI functions, associated data types and common macros.
Access to WinAPI can enabled for a C or C++ program by including it into a source file:
#include <windows.h>
Also, the executable must be linked to each static library that either contains the function code or more commonly defines runtime, dynamic linking to a system dynamic link library (DLL). Generally, for functions in a DLL named like Abc.dll, the program must be linked to a library named like Abc.lib. For MinGW, the library name is like libAbc.dll.a.
Included header files
[edit]Including windows.h results in including various other header files that are included directly or indirectly by windows.h. Many of these header files cannot be included on their own due dependencies between the various header files.
Notable included header files:
Standard C
[edit]- ctype.h – character classification
- stdarg.h – variable-argument function support
- string.h – string and buffer manipulation
Basic
[edit]- basetsd.h – various types [1]
- guiddef.h – the
GUIDtype [2] - imm.h – Input Method Editor (IME)
- winbase.h – kernel32.dll: kernel services; advapi32.dll: kernel services (e.g. CreateProcessAsUser function), access control (e.g. AdjustTokenGroups function).
- wincon.h – console services
- windef.h – various macros and types
- winerror.h – error codes [3]
- wingdi.h – Graphics Device Interface (GDI) [4]
- winnetwk.h – Windows Networking (WNet) [5]
- winnls.h – Native Language Support (NLS)
- winnt.h – various macros and types (for Windows NT) [6]
- winreg.h – Windows registry [7]
- winsvc.h – Windows services and the Service Control Manager (SCM)
- winuser.h – user32.dll: user services, inline resource macro(e.g. MAKEINTRESOURCE macro [8]), inline dialog macro(e.g. DialogBox function [9]). [10]
- winver.h – version information [11]
Extra
[edit]- cderr.h –
CommDlgExtendedErrorfunction error codes - commdlg.h – Common Dialog Boxes
- dde.h – DDE (Dynamic Data Exchange)
- ddeml.h – DDE Management Library
- dlgs.h – various constants for Common Dialog Boxes
- lzexpand.h – LZ (Lempel-Ziv) compression/decompression
- mmsystem.h – Windows Multimedia
- nb30.h – NetBIOS
- rpc.h – RPC (Remote procedure call)
- shellapi.h – Windows Shell API
- wincrypt.h – Cryptographic API
- winperf.h – Performance monitoring
- winresrc.h – used in resources
- winsock.h – Winsock (Windows Sockets), version 1.1
- winspool.h – Print Spooler
- winbgim.h – Standard graphics library
OLE and COM
[edit]- ole2.h – OLE (Object Linking and Embedding)
- objbase.h – COM (Component Object Model)
- oleauto.h – OLE Automation
- olectlid.h – various GUID definitions
Macros
[edit]Several macros affect the definitions made by windows.h and the files it includes.
- UNICODE – when defined, this causes the generic text datatype TCHAR to be a synonym of WCHAR instead of CHAR[12], and all type-generic API functions and messages that work with text will be defined to the -W versions instead of the -A versions. It is similar to the windows C runtime's _UNICODE macro.
- RC_INVOKED – defined when the resource compiler (RC.EXE) is in use instead of a C compiler.
- WINVER – used to enable features only available in newer operating systems. Define it to 0x0501 for Windows XP, and 0x0600 for Windows Vista.
- WIN32_LEAN_AND_MEAN – used to reduce the size of the header files and speed up compilation. Excludes things like cryptography, DDE, RPC, the Windows Shell and Winsock.
