IMsmMerge::ExtractFiles Method

Windows Installer

IMsmMerge::ExtractFiles Method

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

C++HRESULT ExtractFiles(
  [in]  BSTR Path
);

Parameters

Path [in]

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

Return Value

The method can return one of the following 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

VersionMergemod.dll 1.0 or later
HeaderMergemod.h
DLLMergemod.dll
IIDIID_IMsmMerge is defined as 0ADDA82E-2C26-11D2-AD65-00A0C9AF11A6

See Also

Merge Module Automation

Send comments about this topic to Microsoft

Build date: 8/13/2009

© 2009 Microsoft Corporation. All rights reserved.