Skip to content

Latest commit

 

History

History
82 lines (49 loc) · 3.08 KB

installer-openpackage.md

File metadata and controls

82 lines (49 loc) · 3.08 KB
Raw
description ms.assetid title ms.topic ms.date topic_type api_name api_type api_location
The OpenPackage method of the Installer object opens an installer package for use with functions that access the product database and install engine, returning an Session object.
22b03bde-29ae-4dd4-a41c-d55b3a4f424c
Installer.OpenPackage method
reference
05/31/2018
APIRef
kbSyntax
Installer.OpenPackage
COM
Msi.dll

Installer.OpenPackage method

The OpenPackage method of the Installer object opens an installer package for use with functions that access the product database and install engine, returning an Session object.

Syntax

Installer.OpenPackage(
  packagePath,
  options
)

Parameters

packagePath

Required string containing the path name of the package.

options

An optional integer value that specifies whether or not OpenPackage should ignore the current computer state when creating the Session object. No value or a value of 0 for options defaults to the original behavior. When options is 1, the OpenPackage Method ignores the current computer state when opening the package. A value of 1 prevents changes to the current computer state. For more information, see MsiOpenPackageEx.

Return value

This method does not return a value.

Remarks

The OpenPackage method can accept the database handle directly instead of the string for the package path.

Note that only one Session object can be opened by a single process. OpenPackage cannot be used in a custom action because the active installation is the only session allowed.

A safe Session object ignores the current computer state when opening the package and prevents changes to the current computer state. For more information, see MsiOpenPackageEx.

Requirements

Requirement Value
Version
 Windows Installer 5.0 on Windows Server 2012, Windows 8, Windows Server 2008 R2 or Windows 7. Windows Installer 4.0 or Windows Installer 4.5 on Windows Server 2008 or Windows Vista. Windows Installer on Windows Server 2003 or Windows XP
DLL
Msi.dll
IID
 IID_IInstaller is defined as 000C1090-0000-0000-C000-000000000046