Informazioni di riferimento sulle funzioni del programma di installazione

Articolo
06/13/2023

Per abilitare Windows Installer nell'applicazione, è necessario usare le funzioni del programma di installazione. Le tabelle di questo argomento identificano le funzioni per categoria.

Funzioni di registrazione e interfaccia utente

Nome	Descrizione
MsiSetInternalUI	Abilita l'interfaccia utente interna del programma di installazione.
MsiSetExternalUI	Abilita un gestore esterno dell'interfaccia utente che riceve messaggi in formato stringa.
MsiSetExternalUIRecord	Abilita un gestore esterno dell'interfaccia utente che riceve messaggi in formato record.
MsiEnableLog	Imposta la modalità di log per tutte le installazioni nel processo chiamante.

Gestire le funzioni di gestione

Nome	Descrizione
MsiCloseHandle	Chiude un handle di installazione aperto.
MsiCloseAllHandles	Chiude tutti gli handle di installazione aperti. Non usare per la pulizia.

Funzioni di installazione e configurazione

Nome	Descrizione
MsiAdvertiseProduct	Annuncia un prodotto.
MsiAdvertiseProductEx	Annuncia un prodotto.
MsiAdvertiseScript	Copia un file di script di annuncio in percorsi specificati.
MsiInstallProduct	Installa o rimuove un'applicazione o una suite di applicazioni.
MsiConfigureProduct	Installa o rimuove un'applicazione o una suite di applicazioni.
MsiConfigureProductEx	Installa o rimuove un'applicazione o una suite di applicazioni. È possibile specificare una riga di comando del prodotto.
MsiReinstallProduct	Reinstalla o ripristina un'installazione.
MsiConfigureFeature	Configura lo stato installato di una funzionalità.
MsiReinstallFeature	Convalida o ripristina le funzionalità.
MsiInstallMissingComponent	Installa i componenti mancanti.
MsiInstallMissingFile	Installa i file mancanti.
MsiNotifySidChange	Notifica e aggiorna le informazioni interne di Windows Installer con le modifiche apportate ai SID utente. Disponibile a partire da Windows Installer 3.1.
MsiProcessAdvertiseScript	Elabora un file di script di annuncio in percorsi specificati.
MsiSourceListAddSource	Aggiunge o riordina le origini di una patch o di un prodotto in un contesto specificato.
MsiSourceListAddSourceEx	Aggiunge o riordina le origini di una patch o di un prodotto in un contesto specificato. Crea un elenco di origine per una patch che non esiste in un contesto specificato. Disponibile in Windows Installer 3.0.
MsiSourceListClearSource	Rimuove un'origine esistente per un prodotto o una patch in un contesto specificato. Disponibile in Windows Installer 3.0.
MsiSourceListClearAll	Rimuove tutte le origini esistenti di un tipo di origine specifico per un'istanza del prodotto specificata.
MsiSourceListClearAllEx	Rimuove tutte le origini esistenti di un tipo di origine specifico per un'istanza del prodotto specificata. Disponibile in Windows Installer 3.0.
MsiSourceListForceResolution	Rimuove la registrazione dell'origine corrente del prodotto o della patch, registrata come proprietà "LastUsedSource". Questa funzione non influisce sull'elenco di origine registrato.
MsiSourceListForceResolutionEx	Rimuove la registrazione dell'origine corrente del prodotto o della patch, registrata come proprietà "LastUsedSource". Questa funzione non influisce sull'elenco di origine registrato. Disponibile in Windows Installer 3.0.
MsiSourceListGetInfo	Recupera informazioni sull'elenco di origine per un prodotto o una patch in un contesto specifico.
MsiSourceListSetInfo	Imposta l'origine usata più di recente per un prodotto o una patch in un contesto specificato. Disponibile in Windows Installer 3.0.
MsiSourceListEnumMediaDisks	Enumera l'elenco dei dischi registrati per l'origine multimediale per una patch o un prodotto. Disponibile in Windows Installer 3.0.
MsiSourceListAddMediaDisk	Aggiunge o aggiorna un disco dell'origine multimediale di un prodotto o di una patch registrata. Disponibile in Windows Installer 3.0.
MsiSourceListClearMediaDisk	Rimuove un disco registrato esistente nell'origine multimediale per un prodotto o una patch in un contesto specifico. Disponibile in Windows Installer 3.0.
MsiSourceListEnumSources	Enumera le origini nell'elenco di origine di una patch o di un prodotto specificato. Disponibile in Windows Installer 3.0.

Funzioni Component-Specific

Nome	Descrizione
MsiProvideAssembly	Installa e restituisce il percorso completo del componente per un assembly.
MsiProvideComponent	Installa e restituisce il percorso completo del componente di un componente.
MsiProvideQualifiedComponent	Installa e restituisce il percorso completo del componente di un componente qualificato.
MsiProvideQualifiedComponentEx	Installa e restituisce il percorso completo del componente di un componente qualificato pubblicato da un prodotto.
MsiGetComponentPath	Restituisce il percorso completo o la chiave del Registro di sistema a un componente installato.
MsiGetComponentPathEx	Restituisce il percorso completo o la chiave del Registro di sistema a un componente installato negli account utente e nel contesto di installazione. Windows Installer 4.5 e versioni precedenti: Non supportato.
MsiLocateComponent	Restituisce il percorso completo di un componente installato senza codice prodotto.
MsiQueryComponentState	Restituisce lo stato installato per un componente. Può eseguire query sui componenti di un'istanza di un prodotto installato con account utente diversi dall'utente corrente. Disponibile in Windows Installer 3.0 o versione successiva.

Funzioni Application-Only

Nome	Descrizione
MsiCollectUserInfo	Archivia le informazioni utente da un'installazione guidata.
MsiUseFeature	Incrementa il numero di utilizzo per una funzionalità e indica lo stato di installazione.
MsiUseFeatureEx	Incrementa il numero di utilizzo per una funzionalità e indica lo stato di installazione.
MsiGetProductCode	Restituisce il codice prodotto usando il codice del componente.

Funzioni di stato del sistema

Nome	Descrizione
MsiEnumProducts	Enumera i prodotti annunciati.
MsiEnumProductsEx	Enumera tutte le istanze di prodotti annunciati o installati in un contesto specificato. Disponibile in Windows Installer 3.0 o versione successiva.
MsiEnumRelatedProducts	Enumera i prodotti attualmente installati con un codice di aggiornamento specificato.
MsiEnumFeatures	Enumera le funzionalità pubblicate.
MsiEnumComponents	Enumera i componenti installati.
MsiEnumComponentsEx	Enumera i componenti installati tra gli account utente e il contesto di installazione. Windows Installer 4.5 e versioni precedenti: Non supportato.
MsiEnumClients	Enumera i client di un componente installato.
MsiEnumClientsEx	Enumera i client di un componente installato negli account utente e nel contesto di installazione. Windows Installer 4.5 e versioni precedenti: Non supportato.
MsiEnumComponentQualifiers	Enumera i qualificatori annunciati per un componente.
MsiQueryFeatureState	Restituisce lo stato installato di una funzionalità.
MsiQueryFeatureStateEx	Restituisce lo stato installato per una funzionalità del prodotto. Può eseguire query sulle funzionalità di un'istanza di un prodotto installato con account utente diversi dall'utente corrente. Disponibile in Windows Installer 3.0 o versione successiva.
MsiQueryProductState	Restituisce lo stato installato per un'applicazione o una suite di applicazioni.
MsiGetFeatureUsage	Restituisce le metriche di utilizzo per una funzionalità.
MsiGetProductInfo	Restituisce le informazioni sul prodotto per i prodotti pubblicati e installati.
MsiGetProductInfoEx	Restituisce informazioni sul prodotto per i prodotti annunciati e installati. Può recuperare informazioni su un'istanza di un prodotto installato con un account utente diverso dall'utente corrente. Disponibile in Windows Installer 3.0 o versione successiva.
MsiGetUserInfo	Restituisce le informazioni utente registrate per un prodotto installato.

Funzioni di query prodotto

Nome	Descrizione
MsiOpenProduct	Apre un prodotto da usare con le funzioni che accedono al database.
MsiOpenPackage	Apre un pacchetto da usare con le funzioni che accedono al database.
MsiOpenPackageEx	Apre un pacchetto da usare con le funzioni che accedono al database.
MsiIsProductElevated	Controlla se il prodotto è installato con privilegi elevati.
MsiGetProductInfoFromScript	Restituisce le informazioni sul prodotto per un file di script del programma di installazione.
MsiGetProductProperty	Recupera le proprietà nel database del prodotto.
MsiGetShortcutTarget	Esamina un collegamento e restituisce il prodotto, il nome della funzionalità e il componente, se disponibili.
MsiGetFeatureInfo	Restituisce informazioni descrittive per una funzionalità.
MsiVerifyPackage	Verifica che un file specificato sia un pacchetto di installazione.

Funzioni di applicazione di patch

Nome	Descrizione
MsiApplyPatch	Richiama un'installazione e applica un pacchetto patch.
MsiEnumPatches	Restituisce il GUID per ogni patch applicata a un prodotto e un elenco di trasformazioni da ogni patch applicabile al prodotto.
MsiGetPatchInfo	Restituisce informazioni su una patch.
MsiRemovePatches	Disinstalla una patch da un prodotto. Disponibile in Windows Installer 3.0.
MsiDeterminePatchSequence	Determina la sequenza dell'applicazione migliore per un set di patch e prodotti. Disponibile in Windows Installer 3.0.
MsiApplyMultiplePatches	Applica una o più patch ai prodotti. Disponibile in Windows Installer 3.0.
MsiEnumPatchesEx	Enumera tutte le patch applicate per un prodotto in un particolare contesto o in tutti i contesti. Disponibile in Windows Installer 3.0.
MsiGetPatchFileList	Quando viene fornito un elenco di file MSP, questa funzione recupera l'elenco di file che possono essere aggiornati dalle patch per il targe. Disponibile in Windows Installer 4.0.
MsiGetPatchInfoEx	Esegue una query per informazioni sull'applicazione di una patch specificata a un prodotto specificato. Disponibile in Windows Installer 3.0.
MsiExtractPatchXMLData	Estrae informazioni da una patch. Disponibile in Windows Installer 3.0.
MsiDetermineApplicablePatches	Determina il set migliore di patch necessarie per aggiornare un prodotto o un set di prodotti. Disponibile in Windows Installer 3.0.

Funzioni di query file

Nome	Descrizione
MsiGetFileHash	Accetta il percorso di un file e restituisce un hash a 128 bit di tale file.
MsiGetFileSignatureInformation	Accetta il percorso di un file firmato digitalmente e restituisce il certificato e l'hash del firmatario del file.
MsiGetFileVersion	Restituisce la stringa di versione e la stringa di lingua.

Funzioni di gestione delle transazioni

Nome	Descrizione
MsiBeginTransaction	Avvia l'elaborazione delle transazioni di un'installazione a più pacchetti e restituisce un identificatore per la transazione. Questa funzione è disponibile a partire da Windows Installer 4.5.
MsiJoinTransaction	Richiede che Windows Installer eselabori il processo corrente il proprietario della transazione che installa un'installazione multi-pacchetto. Questa funzione è disponibile a partire da Windows Installer 4.5.
MsiEndTransaction	Esegue il commit o il rollback di tutte le installazioni appartenenti alla transazione. Questa funzione è disponibile a partire da Windows Installer 4.5.

Funzioni di database

Oltre alle funzioni di Windows Installer identificate nelle tabelle precedenti, è possibile modificare le informazioni nel database di installazione usando le funzioni di accesso al database descritte nella sezione Funzioni di database .

Strutture del programma di installazione

Inoltre, alcune informazioni nel database di installazione vengono gestite usando le strutture descritte nella sezione Strutture del programma di installazione .