Funzione MsiOpenDatabaseA (msiquery.h)

Articolo
11/20/2024

La funzione msiOpenDatabase apre un file di database per l'accesso ai dati. Questa funzione restituisce un handle che deve essere chiuso usando MsiCloseHandle.

Sintassi

UINT MsiOpenDatabaseA(
  [in]  LPCSTR    szDatabasePath,
  [in]  LPCSTR    szPersist,
  [out] MSIHANDLE *phDatabase
);

Parametri

[in] szDatabasePath

Specifica il percorso completo o il percorso relativo del file di database.

[in] szPersist

Riceve il percorso completo del file o la modalità di persistenza. È possibile usare il parametro szPersist per indirizzare l'output permanente a un nuovo file o per specificare una delle modalità di persistenza predefinite seguenti.

Valore	Significato
MSIDBOPEN_CREATEDIRECT	Creare un nuovo database in modalità diretta di lettura/scrittura.
MSIDBOPEN_CREATE	Creare un nuovo database, modalità transact di lettura/scrittura.
MSIDBOPEN_DIRECT	Aprire un database diretto in lettura/scrittura senza transazione.
MSIDBOPEN_READONLY	Aprire un database di sola lettura, senza modifiche persistenti.
MSIDBOPEN_TRANSACT	Aprire un database di lettura/scrittura in modalità transazione.
MSIDBOPEN_PATCHFILE	Aggiungere questo flag per indicare un file di patch.

[out] phDatabase

Puntatore al percorso dell'handle di database restituito.

Valore restituito

La funzione MsiOpenDatabase restituisce i valori seguenti:

Osservazioni

Per apportare e salvare le modifiche apportate a un database, aprire prima il database nella modalità di transazione (MSIDBOPEN_TRANSACT), crea (MSIDBOPEN_CREATE o MSIDBOPEN_CREATEDIRECT) o diretta (MSIDBOPEN_DIRECT). Dopo aver apportato le modifiche, chiamare sempre MsiDatabaseCommit prima di chiudere l'handle di database. MsiDatabaseCommit scarica tutti i buffer.

Chiamare sempre MsiDatabaseCommit in un database aperto in modalità diretta (MSIDBOPEN_DIRECT o MSIDBOPEN_CREATEDIRECT) prima di chiudere l'handle del database. In caso contrario, il database potrebbe danneggiare il database.

Poiché MsiOpenDatabase avvia l'accesso al database, non può essere usato con un'installazione in esecuzione.

Si noti che è consigliabile usare variabili di tipo PMSIHANDLE perché il programma di installazione chiude gli oggetti PMSIHANDLE quando escono dall'ambito, mentre è necessario chiudere gli oggetti MSIHANDLE chiamando MsiCloseHandle. Per altre informazioni, vedere usare PMSIHANDLE anziché la sezione HANDLE nella Procedure consigliate di Windows Installer.

Nota Quando un database viene aperto come output di un altro database, il flusso di informazioni di riepilogo del database di output è in realtà un mirror di sola lettura del database originale e pertanto non può essere modificato. Inoltre, non è persistente con il database. Per creare o modificare le informazioni di riepilogo per il database di output, è necessario chiuderla e riaprirla.

Se la funzione non riesce, è possibile ottenere informazioni estese sull'errore usando MsiGetLastErrorRecord.

Nota

L'intestazione msiquery.h definisce MsiOpenDatabase come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Installer 5.0 in Windows Server 2012, Windows 8, Windows Server 2008 R2 o Windows 7. Windows Installer 4.0 o Windows Installer 4.5 in Windows Server 2008 o Windows Vista. Windows Installer in Windows Server 2003 o Windows XP
piattaforma di destinazione	Finestre
intestazione	msiquery.h
libreria	Msi.lib
dll	Msi.dll

Vedere anche

esempio di database e patch

funzioni generali di accesso al database

Condividi tramite