_OldExamples
Copyright 2007-2013, 2026 Ivyware Pty Ltd, Khrustal & Mann
             MELBOURNE, VICTORIA, AUSTRALIA, 3000

This product includes software developed by Ivyware Pty Ltd and by
Khrustal & Mann.

Licensed under the Apache License, Version 2.0. See the LICENSE file in
this directory, or http://www.apache.org/licenses/LICENSE-2.0

The three applications here are shipped Ivyware products recovered from their
original release zips and rebuilt against the current Msgcore and TargetCore.
Their source files carried Ivyware's 2007-2013 beta-release notice, which
granted use "provided no fee is charged". That notice has been replaced by the
Apache License, Version 2.0 throughout, by the copyright holder; the Ivyware
copyright attribution is preserved in each file's header, and the year span in
that header is the one that file's own history carries:

    AKAserva   2013, 2026
    AKAssms    2007-2013, 2026
    SQLmapi    2007-2013, 2026

The four run_all.ps1 / smoke.ps1 test harnesses were written in 2026 and
descend from none of that, so they carry "Copyright 2026 Khrustal & Mann"
instead. Not one of the three original zips contained a PowerShell file.


-------------------------------------------------------------------------
Files NOT covered by the Apache License, Version 2.0
-------------------------------------------------------------------------

The following files are Microsoft Corporation project-template, wizard-
generated, or sample-derived files. They remain subject to Microsoft's own
terms and carry their own notices, which must not be removed:

    stdafx.h, stdafx.cpp               Visual Studio project template. One pair
                                       per project (AKAserva\src, AKAssms\src,
                                       SQLmapi\src, SQLmapi\odbc, SQLmapi\mapi).
    Resource.h / resource.h            Visual C++ generated include file.
    *.rc, *.rc2                        Visual C++ generated resource scripts.
    AKAssms\src\targetver.h            Visual Studio project template, verbatim.
                                       See the note below - the other four
                                       targetver.h files are NOT Microsoft's.
    AKAssms\src\ReadMe.txt             MFC Application Wizard output.
    AKAssms\src\AKAssms.reg            MFC Application Wizard output.
    AKAssms\src\ChildFrm.cpp/.h        MFC Application Wizard output for the
    AKAssms\src\ClassView.cpp/.h       "MDI, Visual Studio style" project type.
    AKAssms\src\OutputWnd.cpp/.h       See the note below.
    AKAssms\src\PropertiesWnd.cpp/.h
    AKAssms\src\ViewTree.cpp/.h
    *(2022).sln                        Visual Studio solution files.
    *(2022).vcxproj                    Visual Studio project files.

THE FIVE AKAssms UI CLASSES are listed on evidence rather than on their names.
Each contains zero references to any P2Pmsg, P2Peer, P3Pmsg or Msgcore
identifier: nothing of ours was ever added to them, and CClassView still
displays the wizard's own "FakeApp classes" placeholder tree. Their siblings in
the same directory - MainFrm, FileView, AKAssms.cpp and the rest - are full of
first-party code and ARE covered.

THE OTHER FOUR targetver.h FILES (AKAserva\src, SQLmapi\src, SQLmapi\odbc,
SQLmapi\mapi) are not Microsoft's and are covered by the Apache License. They
were rewritten during the port: nothing of the template survives but "#pragma
once" and one #include, and each carries a paragraph explaining why
WINVER/_WIN32_WINNT is no longer pinned to 0x0600. Only AKAssms\src\targetver.h
is still the wizard's file word for word.

The res\ directories hold wizard-generated icons and bitmaps (*.ico, *.bmp) on
the same footing as the files above.

AKAserva\www\ holds the web fixtures AKAserva\smoke.ps1 serves and checks -
Default.htm, style.css, and the generated 260127-byte large.htm that exercises
the Content-In-Chunks path. They are test data, not source, and carry no header.


-------------------------------------------------------------------------
Third-party source included in this repository
-------------------------------------------------------------------------

    SQLmapi\mapi\mapisdk\mapix.h
    SQLmapi\mapi\mapisdk\mapiutil.h

These are NOT covered by the Apache License, Version 2.0 and are NOT the work
of Ivyware Pty Ltd or Khrustal & Mann. They restore the slice of Microsoft's
Extended MAPI interface declarations that P2PmsgMAPI calls - IMAPIProp,
IMAPITable, IMAPIContainer, IMAPIFolder, IMsgStore, IMessage, IMAPISession,
IAddrBook, the SPropValue/SRowSet/ADRLIST structures, the PROP_TAG machinery
and the PR_* tags used. Those headers left the Windows SDK years ago and are
not present on any SDK version on this machine, while the library half
(MAPI32.Lib) still ships and exports every entry point the code calls.

They are an ABI contract: the interfaces are called through vtables on objects
a MAPI provider creates, so method order and signatures must match Microsoft's
originals member for member, and an unused method still occupies its slot. They
are declarations of Microsoft's interface, reproduced for interoperability, and
must not be relicensed, "tidied", or reordered.


-------------------------------------------------------------------------
Third-party components required at build or run time
-------------------------------------------------------------------------

This software is built against, and links to, components that are licensed
separately and are NOT distributed under the Apache License, Version 2.0:

    Microsoft Foundation Classes (MFC)  - Microsoft, licensed separately. All
                                          three applications are built against
                                          the shared MFC runtime; SQLmapi's two
                                          hubs are MFC extension DLLs.
    Microsoft Visual C++ runtime        - Microsoft, licensed separately.
                                          (mfc140u, msvcp140, vcruntime140,
                                          ucrtbase)
    Windows SDK                         - Microsoft, part of the operating
                                          system. (ws2_32, MsWsock, odbc32,
                                          odbccp32, MAPI32)
    Microsoft ODBC Driver for SQL Server - Microsoft, part of or installed
                                          alongside the operating system.
                                          Reached through odbc32; no source is
                                          included.

These are dependencies, not bundled code. No source from any of them is
included in this repository, with the single exception of the reconstructed
Extended MAPI declarations described in the section above.


-------------------------------------------------------------------------
Sibling MSCS components, not bundled
-------------------------------------------------------------------------

All three applications link against, and stage beside their executables, four
DLLs built from OTHER repositories in this project. They are copied in by a
post-build step from ..\..\bin\<Configuration>64 and are NOT tracked here:

    Msgcore.dll, TargetCore.dll         the two kernels.
    MsgcoreMFC.dll, TargetCoreMFC.dll       their MFC extension DLLs (AKAssms).

Each carries its own LICENSE and NOTICE in its own repository. Nothing in
out\ is tracked by this repository at all.
