Create a Basic Library

[watfordjc]

Feature Branch

Current feature branch for this issue: not created yet.

Progress

• Create a C/C++ Windows DLL project within this solution/repository.
• Implement the following Win32/LTO-Encryption-SPTI functions and export them.
  • HANDLE GetTapeDriveHandle(char* tapeDrivePath)
  • BOOL QueryPropertyForDevice(Handle deviceHandle, ...) (get device serial number, maybe make PSTORAGE_DEVICE_DESCRIPTOR an OUT parameter)
• P/Invoke the functions in LTO-Encryption-Manager, call the functions, and append the serial number to the drive's name.

---

Background

LTO-Encryption-SPTI is currently a linear Win32 C application.

LTO-Encryption-Manager has now reached the point where it needs to use SPTI.

The goal of this issue is to implement the most basic functions as library functions, starting with opening a file descriptor for the tape drive, using a Win32 API to obtain the serial number and WWN/LUN, and then closing the file descriptor.

The Data Backups and Archiving Project contains this loosely related note:

Improve design of LTO-Encryption-SPTI

At the moment there is a lot of repetitive code, redundant code leftover from the template, and the code isn't that clean.
There is also a lot of debugging code and output and very little data being retained after it is queried.
The data in the SCSI VPDs, for example, are mostly burned into the drive's persistent non-volatile memory at the time of manufacture or during a firmware update.
Translate the SCSI pages into structured variables that can be referenced rather than doing the byte and bit stuff inline.