IMsmMerge::ExtractCAB Method

Windows Installer

IMsmMerge::ExtractCAB Method

The ExtractCAB method extracts the embedded .cab file from a module and saves it as the specified file. The installer creates this file if it does not already exist and overwrites the file if it does exist. For more information, see the ExtractCAB method of the Merge object.

IMsmMerge2::ExtractCAB    Mergemod.dll version 2.0 or later.
IMsmMerge::ExtractCAB      All Mergemod.dll versions.

Syntax

C++HRESULT ExtractCAB(
  [in]  BSTR FileName
);

Parameters

FileName [in]

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

Return Value

The method can return one of the following values.

Value Meaning
E_INVALIDARG

One of the arguments is invalid.

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.

S_FALSE

No embedded .cab file was found.

S_OK

The function succeeded.

 

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.