IGR_Extract_Subfile¶
IGR_Extract_Subfile extracts a sub-document to disk from a compound document, given the ID of the sub-document.
The sub-document ID is obtained previously by IGR_Get_Subfile_Entry from the compound document, after being opened by IGR_Open_File.
Prototype¶
IGR_LONG IGR_Extract_Subfile(
IGR_LONG DocHandle,
const IGR_UCS2* ID,
const IGR_UCS2* Destination,
Error_Control_Block* ISYSError);
Parameters¶
DocHandle: IGR_LONG
Is a handle to a file, opened by a call to IGR_Open_File.
ID: Unicode string (UCS2)
Unique ID of the sub-document to be extracted, obtained by a call to IGR_Get_Subfile_Entry.
Destination: Unicode string (UCS2)
Path to a file on disk, where the binary the sub-document will be written.
ISYSError: Pointer to Error_Control_Block
Returns error details if the call fails.
Return value¶
Success: IGR_LONG
Returns IGR_OK.
Failure: IGR_LONG
Returns one of the possible IGR_E error codes.
Sample code¶
Error_Control_Block ISYSError;
IGR_UCS2 ID[4096], Name[1024];
INT64 FileDate, FileSize;
while (true)
{
IGR_LONG rc = IGR_Get_Subfile_Entry(DocHandle, ID, Name, &FileDate, &FileSize,
&ISYSError);
if (rc != IGR_OK)
{
if (rc != IGR_NO_MORE)
// ReportError(rc);
break;
}
rc = IGR_Extract_Subfile(DocHandle, ID, _UCS2("TEMP.DAT"), &ISYSError);
if (rc != IGR_OK)
// ReportError(rc);
else
// DoSomethingWithTheFile("TEMP.DAT", ID, Name);
}