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.