IMsmMerge2::ExtractFilesEx method (mergemod.h)

  • Article

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

Syntax

HRESULT ExtractFilesEx(
  [in]  const BSTR   Path,
  [in]  VARIANT_BOOL fLongFileNames,
  [out] IMsmStrings  **pFilePaths
);

Parameters

[in] Path

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

[in] fLongFileNames

Set to specify using long file names for path segments and final file names.

[out] pFilePaths

A pointer to a memory location. This memory location receives a second pointer to a string enumerator containing a list of fully qualified paths for the files that were extracted. The list is empty if no files can be extracted. This argument may be null. No list is provided if pFilePaths is Null.

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.

Requirements

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

See also

Merge Module Automation