Support SAL Annotations In functions.h

[opalmer]

The functions.h file used to require that you specify functions like this:

BOOL WriteFile(HANDLE, LPCVOID, DWORD, LPDWORD, LPOVERLAPPED);

When the MSDN documentation says:

BOOL WINAPI WriteFile(
    _In_        HANDLE       hFile,
    _In_        LPCVOID      lpBuffer,
    _In_        DWORD        nNumberOfBytesToWrite,
    _Out_opt_   LPDWORD      lpNumberOfBytesWritten,
    _Inout_opt_ LPOVERLAPPED lpOverlapped
);

These are known as SAL Annotations. These annotations are normally used on the Windows side to help with development and reduce defects. For pywincffi, there are two primary purposes:

• Support direct copy/paste from the MSDN documentation
• Make it easier to see at a glance what the expected inputs and outputs are.

[codecov-io]

Current coverage is 98.52%

Merging #94 into master will increase coverage by <.01%

Powered by Codecov. Last updated by 3acaad5...a6d0e7c