IMsmMerge::ExtractFiles method (mergemod.h)

  • Article

The ExtractFiles method extracts the embedded .cab file from a module and then writes those files to the destination directory. For more information, see the ExtractFiles method of the Merge object.

IMsmMerge2::ExtractFiles    Mergemod.dll version 2.0 or later.

 
IMsmMerge::ExtractFiles      All Mergemod.dll versions.

Syntax

HRESULT ExtractFiles(
  [in] const BSTR Path
);

Parameters

[in] Path

The fully qualified destination directory. A LPCWSTR may be used in place of a BSTR.

Return value

This method can return one of these values.

Value Meaning
ERROR_CANNOT_MAKE as HRESULT
 Could not create the output path.
ERROR_OPEN_FAILED as HRESULT
 Could not create the output file.
ERROR_WRITE_FAULT as HRESULT
 Could not write data to the output file.
E_FAIL
 Unable to access embedded .cab file, or create temporary file.
S_FALSE
 No embedded .cab file was found.
S_OK
 The function succeeded.

Remarks

Any files in the destination directory with the same name are overwritten. The path is created if it does not already exist.

ExtractFiles always extracts files using short file names for the path. To use long file names for the path, use the ExtractFilesEx function.

Requirements

Requirement Value
Minimum supported client Mergemod.dll 1.0 or later
Target Platform Windows
Header mergemod.h
DLL Mergemod.dll

See also

Merge Module Automation