Databasfunktioner

Det här materialet är avsett för utvecklare som skriver egna installationsprogram och utvecklare som vill lära sig mer om databastabellerna för installationsprogrammet. Allmän information om installationsprogrammet finns i Om Windows Installer.

Du kan använda installationsåtkomstfunktionerna för att komma åt databasen och installationsprocessen. Dessa funktioner bör endast användas av anpassade installationsåtgärder och redigeringsverktyg. Vissa av installationsåtkomstfunktionerna kräver SQL-frågesträngar för att köra frågor mot databasen. Frågor måste följa installationsprogrammet SQL-syntaxen.

I det här avsnittet visas installationsdatabasens åtkomstfunktioner efter kategori.

Allmänna databasåtkomstfunktioner

Funktion	Beskrivning
MsiDatabaseCommit	Genomför ändringar i en databas.
MsiDatabaseGetPrimaryKeys	Returnerar namnen på alla primärnyckelkolumner.
MsiDatabaseIsTablePersistent	Returnerar en uppräkning som beskriver tillståndet för en tabell.
MsiDatabaseOpenView	Förbereder en databasfråga och skapar ett visningsobjekt.
MsiGetActiveDatabase	Returnerar den aktiva databasen för installationen.
MsiViewGetColumnInfo	Returnerar kolumnnamn eller definitioner.
MsiOpenDatabase	Öppnar en databasfil för dataåtkomst.
MsiViewClose	Släpper resultatuppsättningen för en körd vy.
MsiViewExecute	Kör vyfrågan och tillhandahåller obligatoriska parametrar.
MsiViewFetch	Hämtar nästa sekventiella post från vyn.
MsiViewGetError	Returnerar felet som inträffade i funktionen MsiViewModify.
MsiViewModify	Uppdaterar en hämtad post.

 

Databashanteringsfunktioner

Funktion	Beskrivning
MsiCreateTransformSummaryInfo	Skapar sammanfattningsinformation för en befintlig transformering.
MsiDatabaseApplyTransform	Tillämpar en transformering på en databas.
MsiDatabaseExportera	Exporterar en tabell från en öppen databas till en textarkivfil.
MsiDatabaseGenerateTransform	Genererar en transformeringsfil med skillnader mellan två databaser.
MsiDatabaseImportera	Importerar en installationstextarkivtabell till en öppen databas.
MsiDatabaseMerge	Sammanfogar två databaser.
MsiGetDatabaseState	Returnerar databasens tillstånd.

 

Funktioner för postbearbetning

Funktion	Beskrivning
MsiCreateRecord	Skapar ett nytt postobjekt med angivet antal fält.
MsiFormatRecord	Formaterar postfältdata och egenskaper med hjälp av en formatsträng.
MsiRecordClearData	Anger alla fält i en post till null.
MsiRecordDataSize	Returnerar längden på ett postfält.
MsiRecordGetFieldCount	Returnerar antalet fält i en post.
MsiRecordGetInteger	Returnerar heltalsvärdet från ett postfält.
MsiRecordGetString	Returnerar strängvärdet för ett postfält.
MsiRecordIsNull	Rapporterar om ett postfält är null.
MsiRecordReadStream	Läser byte från ett postströmfält till en buffert.
MsiRecordSetInteger	Anger ett postfält till ett heltalsfält.
MsiRecordSetStream	Anger ett postströmfält från en fil.
MsiRecordSetString	Kopierar en sträng till det avsedda fältet.

 

Egenskapsfunktioner för sammanfattningsinformation

Funktion	Beskrivning
MsiGetSummaryInformation	Hämtar handtag till sammanfattningsinformationsströmmen för installationsprogrammets databas.
MsiSummaryInfoGetProperty	Hämtar en enda egenskap från sammanfattningsinformationen.
MsiSummaryInfoGetPropertyCount	Returnerar antalet egenskaper i sammanfattningsinformationsströmmen.
MsiSummaryInfoPersist	Skriver tillbaka ändrad sammanfattningsinformation till sammanfattningsinformationsströmmen.
MsiSummaryInfoSetProperty	Anger en enda sammanfattningsinformationsegenskap.

 

Åtkomstfunktioner för installationsprogrammets tillstånd

Funktion	Beskrivning
MsiGetLanguage	Returnerar det numeriska språket för den aktuella installationen.
MsiGetLastErrorRecord	Returnerar den felpost som senast returnerades för anropsprocessen.
MsiGetMode	Returnerar ett av de booleska interna installationstillstånden.
MsiGetProperty	Hämtar värdet för en installationsegenskap.
MsiSetProperty	Anger värdet för en installationsegenskap.
MsiSetMode	Anger ett internt motor booleskt tillstånd.

 

Installationsåtgärdsfunktioner

Funktion	Beskrivning
MsiDoAction	Kör inbyggd åtgärd, anpassad åtgärd eller användargränssnittsguide.
MsiEvaluateCondition	Utvärderar ett villkorsuttryck som innehåller egenskapsnamn och värden.
MsiProcessMessage	Skickar en felpost till installationsprogrammet för bearbetning.
MsiSequence	Kör en åtgärdssekvens.

 

Platsfunktioner för installationsprogram

Funktion	Beskrivning
MsiGetSourcePath	Returnerar den fullständiga källsökvägen för en mapp i tabellen Katalog.
MsiGetTargetPath	Returnerar den fullständiga målsökvägen för en mapp i tabellen Katalog.
MsiSetTargetPath	Anger den fullständiga målsökvägen för en mapp i tabellen Katalog.

 

Markeringsfunktioner för installationsprogram

Funktion	Beskrivning
MsiEnumComponentCosts	Räknar upp diskutrymmet per enhet som krävs för att installera en komponent.
MsiGetComponentState	Hämtar tillståndet för en komponent.
MsiGetFeatureCost	Returnerar diskutrymmet som krävs av en funktion.
MsiGetFeatureState	Hämtar tillståndet för en funktion.
MsiGetFeatureValidStates	Returnerar ett giltigt installationstillstånd.
MsiSetComponentState	Anger en komponent till det angivna tillståndet.
MsiSetFeatureAttributes	Ändrar standardattributen för en funktion vid körning.
MsiSetFeatureState	Anger en funktion till ett angivet tillstånd.
MsiSetInstallLevel	Anger installationsnivån för en fullständig produktinstallation.
MsiVerifyDiskSpace	Söker efter tillräckligt med diskutrymme.

 

Användargränssnittsfunktioner

Funktion	Beskrivning
MsiEnableUIPreview	Aktiverar förhandsgranskningsläge för användargränssnittet.
MsiPreviewBillboard	Visar en skylt med värdkontrollen i dialogrutan som visas.
MsiPreviewDialog	Visar en dialogruta som modelös och inaktiv.

 

Alla funktioner stöder både ANSI- och Unicode-anrop. Om du vill använda dessa funktioner inkluderar du MsiQuery.h och länkar till Msi.lib.

Installationsfunktioner

Förutom de databasåtkomstfunktioner som anges ovan skapar du ett installationspaket för ett program med hjälp av installationsfunktionerna som anges i avsnittet Installer Function Reference.