Databázové funkce

Tento materiál je určený pro vývojáře, kteří píší vlastní instalační programy a vývojáře, kteří chtějí získat další informace o tabulkách databáze instalačního programu. Obecné informace o instalačním programu naleznete v tématu O Instalační službě systému Windows.

K přístupu k databázi a procesu instalace můžete použít funkce přístupu instalačního programu. Tyto funkce by měly být používány pouze vlastními instalačními akcemi a nástroji pro vytváření. Některé funkce přístupu k instalačnímu programu vyžadují pro dotazování databáze řetězce dotazů SQL. Dotazy musí dodržovat instalační syntaxi SQL.

Toto téma obsahuje seznam funkcí přístupu k databázi instalačního programu podle kategorie.

Obecné databázové přístupové funkce

Funkce	Popis
MsiDatabaseCommit	Potvrdí změny do databáze.
MsiDatabaseGetPrimaryKeys	Vrátí názvy všech sloupců primárního klíče.
MsiDatabaseIsTablePersistent	Vrátí výčet popisující stav tabulky.
MsiDatabaseOpenView	Připraví databázový dotaz a vytvoří objekt zobrazení.
MsiGetActiveDatabase	Vrátí aktivní databázi pro instalaci.
MsiViewGetColumnInfo	Vrátí názvy sloupců nebo definice.
MsiOpenDatabase	Otevře soubor databáze pro přístup k datům.
MsiViewClose	Uvolní sadu výsledků pro spuštěné zobrazení.
MsiViewExecute	Spustí dotaz zobrazení a poskytuje požadované parametry.
MsiViewFetch	Načte další sekvenční záznam ze zobrazení.
MsiViewGetError	Vrátí chybu, ke které došlo ve funkci MsiViewModify.
MsiViewModify	Aktualizuje načtený záznam.

 

Funkce správy databází

Funkce	Popis
MsiCreateTransformSummaryInfo	Vytvoří souhrnné informace pro existující transformaci.
MsiDatabaseApplyTransform	Použije transformaci na databázi.
MsiDatabaseExport	Exportuje tabulku z otevřené databáze do textového souboru archivu.
MsiDatabaseGenerateTransform	Vygeneruje transformační soubor rozdílů mezi dvěma databázemi.
MsiDatabaseImport	Importuje tabulku archivu textu instalačního programu do otevřené databáze.
MsiDatabaseMerge	Sloučí dvě databáze dohromady.
MsiGetDatabaseState	Vrátí stav databáze.

 

Funkce zpracování záznamů

Funkce	Popis
msiCreateRecord	Vytvoří nový objekt záznamu se zadaným počtem polí.
MsiFormatRecord	Formátuje data a vlastnosti pole záznamu pomocí řetězce formátu.
MsiRecordClearData	Nastaví všechna pole v záznamu na hodnotu null.
MsiRecordDataSize	Vrátí délku pole záznamu.
MsiRecordGetFieldCount	Vrátí počet polí v záznamu.
MsiRecordGetInteger	Vrátí celočíselnou hodnotu z pole záznamu.
msiRecordGetString	Vrátí řetězcovou hodnotu pole záznamu.
MsiRecordIsNull	Zaznamenává, zda pole záznamu má hodnotu null.
MsiRecordReadStream	Čte bajty z pole streamu záznamu do vyrovnávací paměti.
MsiRecordSetInteger	Nastaví pole záznamu na celé číslo.
MsiRecordSetStream	Nastaví pole streamu záznamu ze souboru.
msiRecordSetString	Zkopíruje řetězec do určeného pole.

 

Funkce vlastností souhrnných informací

Funkce	Popis
MsiGetSummaryInformation	Získá popisovač datového proudu souhrnných informací databáze instalačního programu.
msiSummaryInfoGetProperty	Získá jednu vlastnost ze souhrnných informací.
MsiSummaryInfoGetPropertyCount	Vrátí počet vlastností v datovém proudu souhrnných informací.
MsiSummaryInfoPersist	Zapisuje změněné souhrnné informace zpět do souhrnného datového proudu informací.
msiSummaryInfoSetProperty	Nastaví jednu souhrnnou vlastnost informací.

 

Funkce přístupu ke stavu instalačního programu

Funkce	Popis
MsiGetLanguage	Vrátí číselný jazyk aktuální instalace.
MsiGetLastErrorRecord	Vrátí poslední vrácený záznam chyby pro volající proces.
msiGetMode	Vrátí jeden z logických stavů interní instalace.
MsiGetProperty	Získá hodnotu vlastnosti instalačního programu.
msiSetProperty	Nastaví hodnotu vlastnosti instalace.
MsiSetMode	Nastaví logický stav interního modulu.

 

Funkce akcí instalačního programu

Funkce	Popis
msiDoAction	Provede integrovanou akci, vlastní akci nebo akci průvodce uživatelským rozhraním.
MsiEvaluateCondition	Vyhodnotí podmíněný výraz obsahující názvy a hodnoty vlastností.
MsiProcessMessage	Odešle instalačnímu programu záznam chyby ke zpracování.
MsiSequence	Spustí sekvenci akcí.

 

Funkce umístění instalačního programu

Funkce	Popis
MsiGetSourcePath	Vrátí úplnou zdrojovou cestu ke složce v tabulce Adresář.
MsiGetTargetPath	Vrátí úplnou cílovou cestu ke složce v tabulce Adresář.
MsiSetTargetPath	Nastaví úplnou cílovou cestu ke složce v tabulce Adresář.

 

Funkce výběru instalačního programu

Funkce	Popis
msiEnumComponentCosts	Vytvoří výčet místa na disku na jednotku potřebnou k instalaci komponenty.
MsiGetComponentState	Získá stav komponenty.
msiGetFeatureCost	Vrátí místo na disku požadované funkcí.
MsiGetFeatureState	Získá stav funkce.
MsiGetFeatureValidStates	Vrátí platný stav instalace.
MsiSetComponentState	Nastaví komponentu do zadaného stavu.
msiSetFeatureAttributes	Upraví výchozí atributy funkce za běhu.
MsiSetFeatureState	Nastaví funkci na zadaný stav.
MsiSetInstallLevel	Nastaví úroveň instalace úplného produktu.
MsiVerifyDiskSpace	Kontroluje dostatečné místo na disku.

 

Funkce uživatelského rozhraní

Funkce	Popis
msiEnableUIPreview	Povolí režim náhledu uživatelského rozhraní.
MsiPreviewBillboard	Zobrazí plakát s ovládacím prvku hostitele v zobrazeném dialogovém okně.
MsiPreviewDialog	Zobrazí dialogové okno jako bezmodální a neaktivní.

 

Všechny funkce podporují volání ANSI i Unicode. Pokud chcete tyto funkce použít, zahrňte MsiQuery.h a propojte je s Msi.lib.

Funkce instalace

Kromě výše uvedených funkcí pro přístup k databázi vytvoříte instalační balíček pro aplikaci pomocí funkcí instalačního programu uvedených v části Referenční informace o funkcích instalačního programu.