Please Update your bookmarks
The function to create a DocFile is StgCreateDocFile.
function StgCreateDocFile( Unicode filename, STGM flags, Reserved must be 0, Storage returned ) : HResult;
A DocFile is itself a Storage, so here the storage returned is your file's root storage.
To check if the function was successful use the SUCEEDED( ) function.
Hr := StgCreateDocFile(....); if( SUCEEDED( Hr ) ) then begin //DocFile was created end else begin //Create failed end;
Don't compare the HResult to S_OK, unless the help file specifically says that is what the function returns. The reason for this is that OLE can return different values that all mean that the function succeeded but each has a subtly different meaning. In other words there are multiple success (and failure) codes, this allows OLE to provide additional information as to why the function succeeded (or failed).
Before completing the explanation on creating a DocFile I'll quickly
go through some related material that will help you understand
what's going on. This material is also relevant for most of the
other routines to be used later in this article, so lets get this
out of the way.
All information on these www pages is copyright (©) 1997 Andre .v.d. Merwe And may not be copied or mirrored without my permission.