Installationsfunktionsreferens
Om du vill aktivera Windows Installer i ditt program måste du använda installationsfunktionerna. Tabellerna i det här avsnittet identifierar funktionerna efter kategori.
Användargränssnitt och loggningsfunktioner
| Namn | Beskrivning |
|---|---|
| MsiSetInternalUI | Aktiverar installationsprogrammets interna användargränssnitt. |
| MsiSetExternalUI | Aktiverar en extern användargränssnittshanterare som tar emot meddelanden i strängformat. |
| MsiSetExternalUIRecord | Aktiverar en extern användargränssnittshanterare som tar emot meddelanden i postformat. |
| MsiEnableLog | Anger loggläget för alla installationer i anropsprocessen. |
Hantera hanteringsfunktioner
| Namn | Beskrivning |
|---|---|
| MsiCloseHandle | Stänger ett öppet installationshandtag. |
| MsiCloseAllHandles | Stänger alla öppna installationshandtag. Använd inte för rensning. |
Installations- och konfigurationsfunktioner
| Namn | Beskrivning |
|---|---|
| MsiAdvertiseProduct | Annonserar en produkt. |
| MsiAdvertiseProductEx | Annonserar en produkt. |
| MsiAdvertiseScript | Kopierar en annonseringsskriptfil till angivna platser. |
| MsiInstallProduct | Installerar eller tar bort ett program eller en programsvit. |
| MsiConfigureProduct | Installerar eller tar bort ett program eller en programsvit. |
| MsiConfigureProductEx | Installerar eller tar bort ett program eller en programsvit. Du kan ange en produktkommandorad. |
| MsiReinstallProduct | Installerar om eller reparerar en installation. |
| MsiConfigureFeature | Konfigurerar det installerade tillståndet för en funktion. |
| MsiReinstallFeature | Validerar eller reparerar funktioner. |
| MsiInstallMissingComponent | Installerar komponenter som saknas. |
| MsiInstallMissingFile | Installerar filer som saknas. |
| MsiNotifySidChange | Meddelar och uppdaterar intern information för Windows Installer med ändringar i användar-SID:er. Tillgänglig från och med Windows Installer 3.1. |
| MsiProcessAdvertiseScript | Bearbetar en annonseringsskriptfil till angivna platser. |
| MsiSourceListAddSource | Lägger till eller ändrar ordning på källorna för en korrigering eller produkt i en angiven kontext. |
| MsiSourceListAddSourceEx | Lägger till eller ändrar ordning på källorna för en korrigering eller produkt i en angiven kontext. Skapar en källlista för en korrigering som inte finns i en angiven kontext. Finns i Windows Installer 3.0. |
| MsiSourceListClearSource | Tar bort en befintlig källa för en produkt eller korrigering i en angiven kontext. Finns i Windows Installer 3.0. |
| MsiSourceListClearAll | Tar bort alla befintliga källor av en viss källtyp för en angiven produktinstans. |
| MsiSourceListClearAllEx | Tar bort alla befintliga källor av en viss källtyp för en angiven produktinstans. Finns i Windows Installer 3.0. |
| MsiSourceListForceResolution | Tar bort registreringen av den aktuella källan för produkten eller korrigeringen, som är registrerad som egenskapen "LastUsedSource". Den här funktionen påverkar inte listan över registrerade källor. |
| MsiSourceListForceResolutionEx | Tar bort registreringen av den aktuella källan för produkten eller korrigeringen, som är registrerad som egenskapen "LastUsedSource". Den här funktionen påverkar inte listan över registrerade källor. Finns i Windows Installer 3.0. |
| MsiSourceListGetInfo | Hämtar information om källlistan för en produkt eller korrigering i en specifik kontext. |
| MsiSourceListSetInfo | Anger den senast använda källan för en produkt eller korrigering i en angiven kontext. Finns i Windows Installer 3.0. |
| MsiSourceListEnumMediaDisks | Räknar upp listan över diskar som registrerats för mediekällan för en korrigering eller produkt. Finns i Windows Installer 3.0. |
| MsiSourceListAddMediaDisk | Lägger till eller uppdaterar en disk med mediekällan för en registrerad produkt eller korrigering. Finns i Windows Installer 3.0. |
| MsiSourceListClearMediaDisk | Tar bort en befintlig registrerad disk under mediekällan för en produkt eller korrigering i en specifik kontext. Finns i Windows Installer 3.0. |
| MsiSourceListEnumSources | Räknar upp källorna i källlistan för en angiven korrigering eller produkt. Finns i Windows Installer 3.0. |
Component-Specific Functions
| Namn | Beskrivning |
|---|---|
| MsiProvideAssembly | Installerar och returnerar den fullständiga komponentsökvägen för en sammansättning. |
| MsiProvideComponent | Installerar och returnerar den fullständiga komponentsökvägen för en komponent. |
| MsiProvideQualifiedComponent | Installerar och returnerar den fullständiga komponentsökvägen för en kvalificerad komponent. |
| MsiProvideQualifiedComponentEx | Installerar och returnerar den fullständiga komponentsökvägen för en kvalificerad komponent som publiceras av en produkt. |
| MsiGetComponentPath | Returnerar den fullständiga sökvägen eller registernyckeln till en installerad komponent. |
| MsiGetComponentPathEx | Returnerar den fullständiga sökvägen eller registernyckeln till en installerad komponent mellan användarkonton och installationskontexten.
Windows Installer 4.5 och tidigare: Stöds inte. |
| MsiLocateComponent | Returnerar den fullständiga sökvägen till en installerad komponent utan produktkod. |
| MsiQueryComponentState | Returnerar det installerade tillståndet för en komponent. Kan köra frågor mot komponenter i en instans av en produkt som är installerad under andra användarkonton än den aktuella användaren. Finns i Windows Installer 3.0 eller senare. |
Application-Only Functions
| Namn | Beskrivning |
|---|---|
| MsiCollectUserInfo | Lagrar användarinformation från en installationsguide. |
| MsiUseFeature | Ökar användningsantalet för en funktion och anger installationstillstånd. |
| MsiUseFeatureEx | Ökar användningsantalet för en funktion och anger installationstillstånd. |
| MsiGetProductCode | Returnerar produktkod med hjälp av komponentkoden. |
Systemstatusfunktioner
| Namn | Beskrivning |
|---|---|
| MsiEnumProducts | Räknar upp annonserade produkter. |
| MsiEnumProductsEx | Räknar upp alla instanser av annonserade eller installerade produkter i en angiven kontext. Finns i Windows Installer 3.0 eller senare. |
| MsiEnumRelatedProducts | Räknar upp installerade produkter med en angiven uppgraderingskod. |
| MsiEnumFeatures | Räknar upp publicerade funktioner. |
| MsiEnumComponents | Räknar upp de installerade komponenterna. |
| MsiEnumComponentsEx | Räknar upp de installerade komponenterna mellan användarkonton och installationskontexten.
Windows Installer 4.5 och tidigare: Stöds inte. |
| MsiEnumClients | Räknar upp klienterna för en installerad komponent. |
| MsiEnumClientsEx | Räknar upp klienterna för en installerad komponent mellan användarkonton och installationskontext.
Windows Installer 4.5 och tidigare: Stöds inte. |
| MsiEnumComponentQualifiers | Räknar upp de annonserade kvalificerarna för en komponent. |
| MsiQueryFeatureState | Returnerar det installerade tillståndet för en funktion. |
| MsiQueryFeatureStateEx | Returnerar det installerade tillståndet för en produktfunktion. Kan köra frågor mot funktioner i en instans av en produkt som är installerad under andra användarkonton än den aktuella användaren. Finns i Windows Installer 3.0 eller senare. |
| MsiQueryProductState | Returnerar det installerade tillståndet för ett program eller en programsvit. |
| MsiGetFeatureUsage | Returnerar användningsstatistik för en funktion. |
| MsiGetProductInfo | Returnerar produktinformation för publicerade och installerade produkter. |
| MsiGetProductInfoEx | Returnerar produktinformation för annonserade och installerade produkter. Kan hämta information om en instans av en produkt som är installerad under ett annat användarkonto än den aktuella användaren. Finns i Windows Installer 3.0 eller senare. |
| MsiGetUserInfo | Returnerar registrerad användarinformation för en installerad produkt. |
Produktfrågefunktioner
| Namn | Beskrivning |
|---|---|
| MsiOpenProduct | Öppnar en produkt som ska användas med de funktioner som har åtkomst till databasen. |
| MsiOpenPackage | Öppnar ett paket som ska användas med de funktioner som har åtkomst till databasen. |
| MsiOpenPackageEx | Öppnar ett paket som ska användas med de funktioner som har åtkomst till databasen. |
| MsiIsProductElevated | Kontrollerar om produkten är installerad med förhöjd behörighet. |
| MsiGetProductInfoFromScript | Returnerar produktinformation för en installationsskriptfil. |
| MsiGetProductProperty | Hämtar egenskaper i produktdatabasen. |
| MsiGetShortcutTarget | Undersöker en genväg och returnerar dess produkt, funktionsnamn och komponent om den är tillgänglig. |
| MsiGetFeatureInfo | Returnerar beskrivande information för en funktion. |
| MsiVerifyPackage | Verifierar att en angiven fil är ett installationspaket. |
Korrigeringsfunktioner
| Namn | Beskrivning |
|---|---|
| MsiApplyPatch | Anropar en installation och tillämpar ett korrigeringspaket. |
| MsiEnumPatches | Returnerar GUID för varje korrigering som tillämpas på en produkt och en lista över transformeringar från varje korrigering som gäller för produkten. |
| MsiGetPatchInfo | Returnerar information om en korrigering. |
| MsiRemovePatches | Avinstallerar en korrigering från en produkt. Finns i Windows Installer 3.0. |
| MsiDeterminePatchSequence | Avgör den bästa programsekvensen för en uppsättning korrigeringar och produkter. Finns i Windows Installer 3.0. |
| MsiApplyMultiplePatches | Tillämpar en eller flera korrigeringar på produkter. Finns i Windows Installer 3.0. |
| MsiEnumPatchesEx | Räknar upp alla korrigeringar som tillämpas för en produkt i en viss kontext eller i alla kontexter. Finns i Windows Installer 3.0. |
| MsiGetPatchFileList | När en lista med .msp-filer tillhandahålls hämtar den här funktionen listan över filer som kan uppdateras av korrigeringarna för targe. Finns i Windows Installer 4.0. |
| MsiGetPatchInfoEx | Frågar efter information om tillämpningen av en angiven korrigering för en angiven produkt. Finns i Windows Installer 3.0. |
| MsiExtractPatchXMLData | Extraherar information från en korrigering. Finns i Windows Installer 3.0. |
| MsiDetermineApplicablePatches | Avgör den bästa uppsättningen korrigeringar som krävs för att uppdatera en produkt eller uppsättning produkter. Finns i Windows Installer 3.0. |
Filfrågefunktioner
| Namn | Beskrivning |
|---|---|
| MsiGetFileHash | Tar sökvägen till en fil och returnerar en 128-bitars hash för filen. |
| MsiGetFileSignatureInformation | Tar sökvägen till en fil som har signerats digitalt och returnerar filens signercertifikat och hash. |
| MsiGetFileVersion | Returnerar versionssträngen och språksträngen. |
Transaktionshanteringsfunktioner
| Namn | Beskrivning |
|---|---|
| MsiBeginTransaction | Startar transaktionsbearbetningen av en installation med flera paket och returnerar en identifierare för transaktionen. Den här funktionen är tillgänglig från och med Windows Installer 4.5. |
| MsiJoinTransaction | Begär att Windows Installer gör den aktuella processen till ägare av transaktionen som installerar en installation med flera paket. Den här funktionen är tillgänglig från och med Windows Installer 4.5. |
| MsiEndTransaction | Checkar in eller återställer alla installationer som hör till transaktionen. Den här funktionen är tillgänglig från och med Windows Installer 4.5. |
Databasfunktioner
Förutom de Windows Installer-funktioner som identifierades i föregående tabeller kan du ändra information i installationsdatabasen med hjälp av de databasåtkomstfunktioner som beskrivs i avsnittet Database Functions.
Installationsstrukturer
Dessutom hanteras viss information i installationsdatabasen med hjälp av de strukturer som beskrivs i avsnittet Installer Structures.