Introduction
Structured storage is something which, when done using the plain Windows API, seems overly complicated; much more so than is needed. The aim of this article is to briefly introduce you to the concepts behind structured storage, and then provide a helper class to simplify its usage.
The idea behind structured storage is that a single file can itself contain a basic filing system. Its main reason for existence was to help with OLE documents: embedded objects are simply save as separate 'streams' within the single file. Here is a diagram which illustrates this concept:
| STRUCTURED STORAGE FILE |
- First_stream
- Second_stream
- A_storage
|
Although this technology is primarily for use in OLE, it can be put to other uses. In order to help you access the functionality of this powerful tool easily, I have created a helper class, namely CSSFile, to aid in the creation, and modification of structured storage files.
Updates
If you have used this class previously, you will most likely wish to update your code to use the latest version. Here are the main differences (note that the interface remains the same):
- The use of const references for faster parameter passing
- Quicker operation as a result of reduced 'waste' code
- Removal of un-needed variables and code from the class
- Better arrangement of source and header files.
- Integration of help into the article rather than as a HTML Help download.
- Proper UNICODE awareness
Usage of the class
Whilst the class is fairly straightforward, I have listed the functions and their interfaces below to aid your usage of the class:
Function: CreateSSFile(...)
Parameters
filename - the name of the file to be created
mode - the mode of access for the file
Return value
'true' if the file was successfully created
Function: OpenSSFile(...)
Parameters
filename - the name of the file to open
mode - the mode of access for the file
Return value
'true' if the file was successfully opened
Function: Attach(...)
Parameters
pNews - the storage this object should hook
Return value
The previous storage being managed by the object
Function: Detach(...)
No Parameters
Return value
The previous storage being managed by the object
Function: Close()
No Parameters
No Return value
Function: CreateStorage(...)
Parameters
name - the name of the storage to create (will be created within the current path inside the root storage)
enter - enter the storage after creation?
mode - the mode of access for the storage
Return value
'true' if the storage was successfully created
Function: EnterStorage(...)
Parameters
name - the name of the storage to open
mode - the mode of access for the storage
Return value
'true' if the storage was successfully opened
Function: ExitStorage(...)
No Parameters
Return value
'true' if the storage path was moved up a level
Function: CreateStream(...)
Parameters
name - the name of the stream to create
sf - a COleStreamFile into which the stream is opened
mode - the mode of access for the stream
Return value
'true' if the stream was successfully created
Function: OpenStream(...)
Parameters
name - the name of the stream to open
sf - a COleStreamFile into which the stream is opened
mode - the mode of access for the stream
Return value
'true' if the stream was successfully opened
Function: DestroyElement(...)
Parameters
name - the name of the element to destroy
Return value
'true' if the element was successfully destroyed
Function: GetRootStorage()
No Parameters
Return value
The root of the currently open storage
Function: GetCurrentStorage()
No Parameters
Return value
The currently open storage
Function: IsOpen()
No Parameters
Return value
Whether a file is currently being managed by the object
Function: GetFilename()
No Parameters
Return value
The filename of the root storage
Function: GetPath(...)
Parameters
SepChar - the character to be used to separate the paths in the storages (i.e. Windows uses '\' for standard file system paths).
Return value
The current path within the storage (including the filename of the root storage).
Andrew is currently a student at the University of Cambridge, working towards a degree in Computer Science. The word 'working' is used here in a vague sense, with the hope that the reader will realise that the same sentence contained the word 'student'.
Aside from computing he has a strong interest in music, and enjoys the outdoors, particularly when the weather permits going out in them... To Andrew, cycling is fun, sailing is more fun, and the odd camping trip and walk is certainly what the doctor ordered.
In terms of programming experience, he first started writing programs for the Commodore Amiga using BASIC, after which he learned the joys of C and has never looked back. Since, he has added C++ and C# to his repotoire, along with a bunch of other crazy languages like ML that they like to teach in college.
General 
News 
Suggestion 
Question 
Bug 
Answer 
Joke 
Praise 
Rant 
Admin 
Submit an article or tip
) as this is my first ever c++ code.
.. i take that c# can call dll's, I could give you my a copy of my code but this is only writen to deal with msg files and only the things i need to get (sender name, sender email, to name, date, subject, body, attachment count etc..)