The MsiCloseHandle function closes an open installation handle.

Syntax

C++UINT MsiCloseHandle(
  __in  MSIHANDLE hAny
);

Parameters

hAny [in]

Specifies any open installation handle.

Return Value

Remarks

MsiCloseHandle must be called from the same thread that requested the creation of the handle.

The following functions supply handles that should be closed after use by calling MsiCloseHandle:

MsiCreateRecord

MsiGetActiveDatabase

MsiGetLastErrorRecord

MsiOpenPackage

MsiOpenProduct

MsiOpenDatabase

MsiDatabaseOpenView

MsiViewFetch

MsiViewGetColumnInfo

MsiDatabaseGetPrimaryKeys

MsiGetSummaryInformation

MsiEnableUIPreview

Note that when writing custom actions, it is recommended to use variables of type PMSIHANDLE because the installer closes PMSIHANDLE objects as they go out of scope, whereas you must close MSIHANDLE objects by calling MsiCloseHandle.

For example, if you use code like this:

MSIHANDLE hRec = MsiCreateRecord(3);

Change it to:

PMSIHANDLE hRec = MsiCreateRecord(3);

Requirements

See Also

Handle Management Functions

Send comments about this topic to Microsoft

Build date: 8/13/2009