MsiGetDatabaseState Function

Windows Installer

MsiGetDatabaseState Function

The MsiGetDatabaseState function returns the state of the database.

Syntax

C++MSIDBSTATE MsiGetDatabaseState(
  __in  MSIHANDLE hDatabase
);

Parameters

hDatabase [in]

Handle to the database obtained from MsiOpenDatabase.

Return Value

MSIDBSTATE_READ

The database is opened as read-only; there can be no persistent changes.

MSIDBSTATE_ERROR

An invalid database handle was passed to the function.

MSIDBSTATE_WRITE

The database is readable and writable.

Remarks

The MsiGetDatabaseState function returns the update state of the database.

Requirements

VersionWindows Installer 5.0 on 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, Windows XP, and Windows 2000
HeaderMsiquery.h
LibraryMsi.lib
DLLMsi.dll

See Also

Database Management Functions

Send comments about this topic to Microsoft

Build date: 8/13/2009

© 2009 Microsoft Corporation. All rights reserved.