Condividi tramite


Informazioni di riferimento sulle funzioni del programma di installazione

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 .