Condividi tramite


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.