Funzioni di database

Questo materiale è destinato agli sviluppatori che scrivono programmi di installazione e sviluppatori che vogliono ottenere altre informazioni sulle tabelle di database del programma di installazione. Per informazioni generali sul programma di installazione, vedere Informazioni su Windows Installer.

È possibile usare le funzioni di accesso del programma di installazione per accedere al database e al processo di installazione. Queste funzioni devono essere usate solo da azioni di installazione personalizzate e strumenti di creazione. Alcune delle funzioni di accesso al programma di installazione richiedono stringhe di query SQL per l'esecuzione di query sul database. Le query devono rispettare la sintassi SQL del programma di installazione.

In questo argomento vengono elencate le funzioni di accesso al database del programma di installazione per categoria.

Funzioni generali di accesso al database

Funzione	Descrizione
MsiDatabaseCommit	Esegue il commit delle modifiche apportate a un database.
MsiDatabaseGetPrimaryKeys	Restituisce i nomi di tutte le colonne chiave primaria.
MsiDatabaseIsTablePersistent	Restituisce un'enumerazione che descrive lo stato di una tabella.
MsiDatabaseOpenView	Prepara una query di database e crea un oggetto vista.
MsiGetActiveDatabase	Restituisce il database attivo per l'installazione.
MsiViewGetColumnInfo	Restituisce nomi o definizioni di colonna.
MsiOpenDatabase	Apre un file di database per l'accesso ai dati.
MsiViewClose	Rilascia il set di risultati per una visualizzazione eseguita.
MsiViewExecute	Esegue la query di visualizzazione e fornisce i parametri obbligatori.
MsiViewFetch	Recupera il record sequenziale successivo dalla visualizzazione.
MsiViewGetError	Restituisce l'errore che si è verificato nella funzione MsiViewModify .
MsiViewModify	Aggiornamenti un record recuperato.

 

Funzioni di gestione del database

Funzione	Descrizione
MsiCreateTransformSummaryInfo	Crea informazioni di riepilogo per una trasformazione esistente.
MsiDatabaseApplyTransform	Applica una trasformazione a un database.
MsiDatabaseExport	Esporta una tabella da un database aperto in un file di archivio di testo.
MsiDatabaseGenerateTransform	Genera un file di trasformazione delle differenze tra due database.
MsiDatabaseImport	Importa una tabella di archiviazione del testo del programma di installazione in un database aperto.
MsiDatabaseMerge	Unisce due database.
MsiGetDatabaseState	Restituisce lo stato del database.

 

Funzioni di elaborazione record

Funzione	Descrizione
MsiCreateRecord	Crea un nuovo oggetto record con il numero specificato di campi.
MsiFormatRecord	Formatta i dati e le proprietà dei campi di record usando una stringa di formato.
MsiRecordClearData	Imposta tutti i campi di un record su Null.
MsiRecordDataSize	Restituisce la lunghezza di un campo record.
MsiRecordGetFieldCount	Restituisce il numero di campi in un record.
MsiRecordGetInteger	Restituisce il valore intero da un campo record.
MsiRecordGetString	Restituisce il valore stringa di un campo record.
MsiRecordIsNull	Indica se un campo record è Null.
MsiRecordReadStream	Legge i byte da un campo del flusso di record in un buffer.
MsiRecordSetInteger	Imposta un campo record su un campo integer.
MsiRecordSetStream	Imposta un campo del flusso di record da un file.
MsiRecordSetString	Copia una stringa nel campo designato.

 

Funzioni delle proprietà Summary Information

Funzione	Descrizione
MsiGetSummaryInformation	Ottiene l'handle per il flusso di informazioni di riepilogo del database del programma di installazione.
MsiSummaryInfoGetProperty	Ottiene una singola proprietà dalle informazioni di riepilogo.
MsiSummaryInfoGetPropertyCount	Restituisce il numero di proprietà nel flusso di informazioni di riepilogo.
MsiSummaryInfoPersist	Scrive le informazioni di riepilogo modificate nel flusso di informazioni di riepilogo.
MsiSummaryInfoSetProperty	Imposta una singola proprietà di informazioni di riepilogo.

 

Funzioni di accesso allo stato del programma di installazione

Funzione	Descrizione
MsiGetLanguage	Restituisce la lingua numerica dell'installazione corrente.
MsiGetLastErrorRecord	Restituisce l'ultimo record di errore restituito per il processo di chiamata.
MsiGetMode	Restituisce uno degli stati di installazione interni booleani.
MsiGetProperty	Ottiene il valore di una proprietà del programma di installazione.
MsiSetProperty	Imposta il valore di una proprietà di installazione.
MsiSetMode	Imposta uno stato booleano del motore interno.

 

Funzioni di azione del programma di installazione

Funzione	Descrizione
MsiDoAction	Esegue un'azione predefinita, un'azione personalizzata o un'azione guidata dell'interfaccia utente.
MsiEvaluateCondition	Valuta un'espressione condizionale contenente nomi di proprietà e valori.
MsiProcessMessage	Invia un record di errore al programma di installazione per l'elaborazione.
MsiSequence	Esegue una sequenza di azioni.

 

Funzioni percorso del programma di installazione

Funzione	Descrizione
MsiGetSourcePath	Restituisce il percorso di origine completo per una cartella nella tabella Directory.
MsiGetTargetPath	Restituisce il percorso di destinazione completo per una cartella nella tabella Directory.
MsiSetTargetPath	Imposta il percorso di destinazione completo per una cartella nella tabella Directory.

 

Funzioni di selezione del programma di installazione

Funzione	Descrizione
MsiEnumComponentCosts	Enumera lo spazio su disco per unità necessario per installare un componente.
MsiGetComponentState	Ottiene lo stato di un componente.
MsiGetFeatureCost	Restituisce lo spazio su disco richiesto da una funzionalità.
MsiGetFeatureState	Ottiene lo stato di una funzionalità.
MsiGetFeatureValidStates	Restituisce uno stato di installazione valido.
MsiSetComponentState	Imposta un componente sullo stato specificato.
MsiSetFeatureAttributes	Modifica gli attributi predefiniti di una funzionalità in fase di esecuzione.
MsiSetFeatureState	Imposta una funzionalità su uno stato specificato.
MsiSetInstallLevel	Imposta il livello di installazione di un'installazione completa del prodotto.
MsiVerifyDiskSpace	Verifica la presenza di spazio su disco sufficiente.

 

Funzioni dell'interfaccia utente

Funzione	Descrizione
MsiEnableUIPreview	Abilita la modalità di anteprima dell'interfaccia utente.
MsiPreviewBillboard	Visualizza un cartellone con il controllo host nella finestra di dialogo visualizzata.
MsiPreviewDialog	Visualizza una finestra di dialogo come senza modalità e inattiva.

 

Tutte le funzioni supportano chiamate ANSI e Unicode. Per usare queste funzioni, includere MsiQuery.h e collegamento con Msi.lib.

Funzioni di installazione

Oltre alle funzioni di accesso al database elencate sopra, si crea un pacchetto di installazione per un'applicazione usando le funzioni del programma di installazione elencate nella sezione Informazioni di riferimento sulla funzione del programma di installazione.