MsiOpenProduct

[This is preliminary documentation and subject to change.]

The MsiOpenProduct function opens a product for use with the functions that access the product database. The MsiCloseHandle function must be called with the handle when the handle is no longer needed.

UINT MsiOpenProduct(
  LPCTSTR szProduct,   // product code
  MSIHANDLE *hProduct  // returned product handle, must be closed
);
 

Parameters

szProduct
Specifies the product code of the product to be opened.
hProduct
Pointer to a variable that receives the product handle.

Return Values

ERROR_BAD_CONFIGURATION
The configuration information is corrupt.
ERROR_INSTALL_FAILURE
The product could not be opened.
ERROR_INSTALL_SOURCE_ABSENT
The source was unavailable.
ERROR_INVALID_PARAMETER
An invalid parameter was passed to the function.
ERROR_SUCCESS
The function completed successfully.
ERROR_UNKNOWN_PRODUCT
The product code was unrecognized.

QuickInfo

  Windows NT: Requires version 4.0 or later. Available as a redistributable for Windows NT 4.0.
  Windows: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Windows CE: Unsupported.
  Header: Declared in msi.h.
  Import Library: Use msi.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT.

See Also

Product Query Functions