Referenční informace k funkcím instalačního programu

Chcete-li povolit Instalační službu systému Windows ve vaší aplikaci, musíte použít instalační funkce. Tabulky v tomto tématu identifikují funkce podle kategorie.

Funkce uživatelského rozhraní a protokolování

Jméno	Popis
MsiSetInternalUI	Povolí interní uživatelské rozhraní instalačního programu.
MsiSetExternalUI	Povolí obslužnou rutinu externího uživatelského rozhraní, která přijímá zprávy ve formátu řetězce.
MsiSetExternalUIZáznam	Povolí obslužnou rutinu externího uživatelského rozhraní, která přijímá zprávy ve formátu záznamu.
MsiEnableLog	Nastaví režim protokolu pro všechny instalace ve volajícím procesu.

 

Zpracování funkcí správy

Jméno	Popis
MsiCloseHandle	Zavře otevřený instalační popisovač.
msiCloseAllHandles	Zavře všechny otevřené instalační popisovače. Nepoužívejte k vyčištění.

 

Instalační a konfigurační funkce

Jméno	Popis
msiAdvertiseProduct	Inzeruje produkt.
msiAdvertiseProductEx	Inzeruje produkt.
msiAdvertiseScript	Zkopíruje inzerovaný soubor skriptu do zadaných umístění.
MsiInstallProduct	Nainstaluje nebo odebere aplikaci nebo sadu aplikací.
MsiConfigureProduct	Nainstaluje nebo odebere aplikaci nebo sadu aplikací.
msiConfigureProductEx	Nainstaluje nebo odebere aplikaci nebo sadu aplikací. Je možné zadat příkazový řádek produktu.
msiReinstallProduct	Přeinstaluje nebo opraví instalaci.
MsiConfigureFeature	Konfiguruje nainstalovaný stav funkce.
MsiReinstallFeature	Ověřuje nebo opravuje funkce.
msiInstallMissingComponent	Nainstaluje chybějící komponenty.
msiInstallMissingFile	Nainstaluje chybějící soubory.
msiNotifySidChange	Upozorní a aktualizuje interní informace Instalační služby systému Windows o změnách identifikátorů SID uživatelů. K dispozici od Instalační služby systému Windows 3.1.
msiProcessAdvertiseScript	Zpracuje inzerovaný soubor skriptu do zadaných umístění.
msiSourceListAddSource	Přidá nebo změní pořadí zdrojů opravy nebo produktu v zadaném kontextu.
MsiSourceListAddSourceEx	Přidá nebo změní pořadí zdrojů opravy nebo produktu v zadaném kontextu. Vytvoří zdrojový seznam pro opravu, která v zadaném kontextu neexistuje. K dispozici v Instalační službě systému Windows 3.0.
msiSourceListClearSource	Odebere existující zdroj produktu nebo opravy v zadaném kontextu. K dispozici v Instalační službě systému Windows 3.0.
MsiSourceListClearAll	Odebere všechny existující zdroje konkrétního typu zdroje pro zadanou instanci produktu.
MsiSourceListClearAllEx	Odebere všechny existující zdroje konkrétního typu zdroje pro zadanou instanci produktu. K dispozici v Instalační službě systému Windows 3.0.
MsiSourceListForceResolution	Odebere registraci aktuálního zdroje produktu nebo opravy, která je registrována jako vlastnost LastUsedSource. Tato funkce nemá vliv na registrovaný zdrojový seznam.
MsiSourceListForceResolutionEx	Odebere registraci aktuálního zdroje produktu nebo opravy, která je registrována jako vlastnost LastUsedSource. Tato funkce nemá vliv na registrovaný zdrojový seznam. K dispozici v Instalační službě systému Windows 3.0.
MsiSourceListGetInfo	Načte informace o zdrojovém seznamu produktu nebo opravy v určitém kontextu.
MsiSourceListSetInfo	Nastaví naposledy použitý zdroj produktu nebo opravy v zadaném kontextu. K dispozici v Instalační službě systému Windows 3.0.
MsiSourceListEnumMediaDisks	Vytvoří výčet disků registrovaných pro zdroj médií pro opravu nebo produkt. K dispozici v Instalační službě systému Windows 3.0.
MsiSourceListAddMediaDisk	Přidá nebo aktualizuje disk zdroje médií registrovaného produktu nebo opravy. K dispozici v Instalační službě systému Windows 3.0.
MsiSourceListClearMediaDisk	Odebere existující registrovaný disk pod zdrojem médií pro produkt nebo opravu v určitém kontextu. K dispozici v Instalační službě systému Windows 3.0.
MsiSourceListEnumSources	Vytvoří výčet zdrojů ve zdrojovém seznamu zadané opravy nebo produktu. K dispozici v Instalační službě systému Windows 3.0.

 

funkce Component-Specific

Jméno	Popis
MsiProvideAssembly	Nainstaluje a vrátí úplnou cestu ke komponentě sestavení.
msiProvideComponent	Nainstaluje a vrátí úplnou cestu ke komponentě.
msiProvideQualifiedComponent	Nainstaluje a vrátí úplnou cestu ke komponentě kvalifikované komponenty.
MsiProvideQualifiedComponentEx	Nainstaluje a vrátí úplnou cestu ke komponentě kvalifikované součásti publikované produktem.
msiGetComponentPath	Vrátí úplnou cestu nebo klíč registru nainstalované součásti.
MsiGetComponentPathEx	Vrátí úplnou cestu nebo klíč registru k nainstalované komponentě napříč uživatelskými účty a kontextem instalace. Instalační služba systému Windows 4.5 a starší: Nepodporuje se.
msiLocateComponent	Vrátí úplnou cestu k nainstalované komponentě bez kódu produktu.
MsiQueryComponentState	Vrátí stav instalace součásti. Může dotazovat komponenty instance produktu nainstalované v jiných uživatelských účtech než aktuální uživatel. K dispozici v Instalační službě systému Windows 3.0 nebo novější.

 

funkce Application-Only

Jméno	Popis
MsiCollectUserInfo	Ukládá informace o uživatelích z průvodce instalací.
MsiUseFeature	Zvýší počet využití pro funkci a indikuje stav instalace.
MsiUseFeatureEx	Zvýší počet využití pro funkci a indikuje stav instalace.
msiGetProductCode	Vrátí kód produktu pomocí kódu komponenty.

 

Funkce stavu systému

Jméno	Popis
MsiEnumProducts	Výčet inzerovaných produktů.
MsiEnumProductsEx	Vytvoří výčet všech instancí inzerovaných nebo nainstalovaných produktů v zadaném kontextu. K dispozici v Instalační službě systému Windows 3.0 nebo novější.
MsiEnumRelatedProducts	Vytvoří výčet aktuálně nainstalovaných produktů se zadaným kódem upgradu.
MsiEnumFeatures	Vytvoří výčet publikovaných funkcí.
msiEnumComponents	Vytvoří výčet nainstalovaných komponent.
MsiEnumComponentsEx	Vytvoří výčet nainstalovaných komponent napříč uživatelskými účty a kontextem instalace. Instalační služba systému Windows 4.5 a starší: Nepodporuje se.
MsiEnumClients	Vytvoří výčet klientů nainstalované komponenty.
MsiEnumClientsEx	Vytvoří výčet klientů nainstalované komponenty napříč uživatelskými účty a kontextem instalace. Instalační služba systému Windows 4.5 a starší: Nepodporuje se.
MsiEnumComponentQualifiers	Vytvoří výčet inzerovaných kvalifikátorů pro komponentu.
MsiQueryFeatureState	Vrátí nainstalovaný stav funkce.
MsiQueryFeatureStateEx	Vrátí stav instalace pro funkci produktu. Může dotazovat funkce instance produktu nainstalované v jiných uživatelských účtech než aktuální uživatel. K dispozici v Instalační službě systému Windows 3.0 nebo novější.
MsiQueryProductState	Vrátí stav instalace pro aplikaci nebo sadu aplikací.
MsiGetFeatureUsage	Vrátí metriky využití pro funkci.
msiGetProductInfo	Vrátí informace o produktu pro publikované a nainstalované produkty.
msiGetProductInfoEx	Vrátí informace o produktu pro inzerované a nainstalované produkty. Může načíst informace o instanci produktu nainstalovaného v jiném uživatelském účtu, než je aktuální uživatel. K dispozici v Instalační službě systému Windows 3.0 nebo novější.
MsiGetUserInfo	Vrátí registrované informace o uživateli nainstalovaného produktu.

 

Funkce dotazů produktu

Jméno	Popis
msiOpenProduct	Otevře produkt, který se použije s funkcemi, které přistupí k databázi.
MsiOpenPackage	Otevře balíček, který se použije s funkcemi, které přistupí k databázi.
MsiOpenPackageEx	Otevře balíček, který se použije s funkcemi, které přistupí k databázi.
msiIsProductElevated	Zkontroluje, jestli je produkt nainstalovaný se zvýšenými oprávněními.
MsiGetProductInfoFromScript	Vrátí informace o produktu pro soubor skriptu instalačního programu.
msiGetProductProperty	Načte vlastnosti v databázi produktů.
msiGetShortcutTarget	Zkontroluje zástupce a vrátí jeho produkt, název funkce a součást, pokud je k dispozici.
MsiGetFeatureInfo	Vrátí popisné informace pro funkci.
msiVerifyPackage	Ověřuje, že zadaný soubor je instalační balíček.

 

Opravy funkcí

Jméno	Popis
MsiApplyPatch	Vyvolá instalaci a použije balíček oprav.
MsiEnumPatches	Vrátí identifikátor GUID pro každou opravu použitou na produkt a seznam transformací z každé opravy, která se vztahuje na produkt.
MsiGetPatchInfo	Vrátí informace o opravě.
MsiRemovePatches	Odinstaluje opravu z produktu. K dispozici v Instalační službě systému Windows 3.0.
msiDeterminePatchSequence	Určuje nejlepší posloupnost aplikací pro sadu oprav a produktů. K dispozici v Instalační službě systému Windows 3.0.
msiApplyMultiplePatches	Použije na produkty jednu nebo více oprav. K dispozici v Instalační službě systému Windows 3.0.
MsiEnumPatchesEx	Vytvoří výčet všech oprav použitých pro produkt v určitém kontextu nebo napříč všemi kontexty. K dispozici v Instalační službě systému Windows 3.0.
msiGetPatchFileList	Při poskytnutí seznamu souborů .msp tato funkce načte seznam souborů, které lze aktualizovat opravami pro targe. K dispozici v Instalační službě systému Windows 4.0.
msiGetPatchInfoEx	Dotazy na informace o použití zadané opravy pro zadaný produkt. K dispozici v Instalační službě systému Windows 3.0.
MsiExtractPatchXMLData	Extrahuje informace z opravy. K dispozici v Instalační službě systému Windows 3.0.
MsiDetermineApplicablePatches	Určuje nejlepší sadu oprav potřebných k aktualizaci produktu nebo sady produktů. K dispozici v Instalační službě systému Windows 3.0.

 

Funkce dotazování souborů

Jméno	Popis
msiGetFileHash	Vezme cestu k souboru a vrátí 128bitovou hodnotu hash daného souboru.
MsiGetFileSignatureInformation	Vezme cestu k souboru, který byl digitálně podepsaný a vrátí podpisový certifikát a hodnotu hash souboru.
MsiGetFileVersion	Vrátí řetězec verze a řetězec jazyka.

 

Funkce správy transakcí

Jméno	Popis
MsiBeginTransaction	Spustí zpracování transakcí instalace více balíčků a vrátí identifikátor transakce. Tato funkce je dostupná od Instalační služby systému Windows 4.5.
MsiJoinTransaction	Požaduje, aby instalační služba systému Windows aktuální proces vlastník transakce instalace multi-package instalace. Tato funkce je dostupná od Instalační služby systému Windows 4.5.
msiEndTransaction	Potvrdí nebo vrátí zpět všechny instalace patřící k transakci. Tato funkce je dostupná od Instalační služby systému Windows 4.5.

 

Databázové funkce

Kromě funkcí Instalační služby systému Windows identifikovaných v předchozích tabulkách můžete manipulovat s informacemi v instalační databázi pomocí funkcí přístupu k databázi, které jsou popsány v části Databázové funkce.

Struktury instalačního programu

Kromě toho se některé informace v instalační databázi zpracovávají pomocí struktur popsaných v části Struktury instalačního programu.