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 .