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.