Udostępnij za pośrednictwem

Dokumentacja funkcji instalatora

  • Artykuł

Aby włączyć Instalatora Windows w aplikacji, należy użyć funkcji instalatora. Tabele w tym temacie identyfikują funkcje według kategorii.

Interfejs użytkownika i funkcje rejestrowania

Nazwa Opis
MsiSetInternalUI Włącza wewnętrzny interfejs użytkownika instalatora.
MsiSetExternalUI Włącza zewnętrzną procedurę obsługi interfejsu użytkownika, która odbiera komunikaty w formacie ciągu.
MsiSetExternalUIRecord Włącza zewnętrzną procedurę obsługi interfejsu użytkownika, która odbiera komunikaty w formacie rekordu.
MsiEnableLog Ustawia tryb dziennika dla wszystkich instalacji w procesie wywoływania.

 

Obsługa funkcji zarządzania

Nazwa Opis
MsiCloseHandle Zamyka otwarty uchwyt instalacji.
MsiCloseAllHandles Zamyka wszystkie otwarte dojścia instalacji. Nie należy używać do czyszczenia.

 

Funkcje instalacji i konfiguracji

Nazwa Opis
msiAdvertiseProduct Reklamuje produkt.
MsiAdvertiseProductEx Reklamuje produkt.
msiAdvertiseScript Kopiuje plik skryptu anonsowania do określonych lokalizacji.
MsiInstallProduct Instaluje lub usuwa aplikację lub pakiet aplikacji.
MsiConfigureProduct Instaluje lub usuwa aplikację lub pakiet aplikacji.
MsiConfigureProductEx Instaluje lub usuwa aplikację lub pakiet aplikacji. Można określić wiersz polecenia produktu.
MsiReinstallProduct Instaluje ponownie lub naprawia instalację.
MsiConfigureFeature Konfiguruje zainstalowany stan funkcji.
MsiReinstallFeature Weryfikuje lub naprawia funkcje.
MsiInstallMissingComponent Instaluje brakujące składniki.
MsiInstallMissingFile Instaluje brakujące pliki.
MsiNotifySidChange Powiadamia i aktualizuje informacje wewnętrzne Instalatora Windows o zmianach identyfikatorów SID użytkownika. Dostępne począwszy od Instalatora Windows 3.1.
MsiProcessAdvertiseScript Przetwarza plik skryptu anonsowania do określonych lokalizacji.
MsiSourceListAddSource Dodaje lub zmienia kolejność źródeł poprawki lub produktu w określonym kontekście.
MsiSourceListAddSourceEx Dodaje lub zmienia kolejność źródeł poprawki lub produktu w określonym kontekście. Tworzy listę źródłową poprawki, która nie istnieje w określonym kontekście. Dostępne w Instalatorze Windows 3.0.
MsiSourceListClearSource Usuwa istniejące źródło produktu lub poprawki w określonym kontekście. Dostępne w Instalatorze Windows 3.0.
MsiSourceListClearAll Usuwa wszystkie istniejące źródła określonego typu źródłowego dla określonego wystąpienia produktu.
MsiSourceListClearAllEx Usuwa wszystkie istniejące źródła określonego typu źródłowego dla określonego wystąpienia produktu. Dostępne w Instalatorze Windows 3.0.
MsiSourceListForceResolution Usuwa rejestrację bieżącego źródła produktu lub poprawki, która jest zarejestrowana jako właściwość "LastUsedSource". Ta funkcja nie ma wpływu na zarejestrowaną listę źródłową.
MsiSourceListForceResolutionEx Usuwa rejestrację bieżącego źródła produktu lub poprawki, która jest zarejestrowana jako właściwość "LastUsedSource". Ta funkcja nie ma wpływu na zarejestrowaną listę źródłową. Dostępne w Instalatorze Windows 3.0.
MsiSourceListGetInfo Pobiera informacje o liście źródłowej produktu lub poprawki w określonym kontekście.
MsiSourceListSetInfo Ustawia ostatnio używane źródło produktu lub poprawki w określonym kontekście. Dostępne w Instalatorze Windows 3.0.
MsiSourceListEnumMediaDisks Wylicza listę dysków zarejestrowanych dla źródła multimediów dla poprawki lub produktu. Dostępne w Instalatorze Windows 3.0.
MsiSourceListAddMediaDisk Dodaje lub aktualizuje dysk źródła nośnika zarejestrowanego produktu lub poprawki. Dostępne w Instalatorze Windows 3.0.
MsiSourceListClearMediaDisk Usuwa istniejący zarejestrowany dysk w źródle nośnika dla produktu lub poprawki w określonym kontekście. Dostępne w Instalatorze Windows 3.0.
MsiSourceListEnumSources Wylicza źródła na liście źródłowej określonej poprawki lub produktu. Dostępne w Instalatorze Windows 3.0.

 

Component-Specific Functions

Nazwa Opis
MsiProvideAssembly Instaluje i zwraca pełną ścieżkę składnika dla zestawu.
MsiProvideComponent Instaluje i zwraca pełną ścieżkę składnika.
MsiProvideQualifiedComponent Instaluje i zwraca pełną ścieżkę składnika kwalifikowanego składnika.
MsiProvideQualifiedComponentEx Instaluje i zwraca pełną ścieżkę składnika kwalifikowanego, który jest publikowany przez produkt.
MsiGetComponentPath Zwraca pełną ścieżkę lub klucz rejestru do zainstalowanego składnika.
MsiGetComponentPathEx Zwraca pełną ścieżkę lub klucz rejestru do zainstalowanego składnika na kontach użytkowników i kontekście instalacji. Instalatora Windows 4.5 i starszych: Nieobsługiwane.
MsiLocateComponent Zwraca pełną ścieżkę do zainstalowanego składnika bez kodu produktu.
msiQueryComponentState Zwraca zainstalowany stan składnika. Może wykonywać zapytania dotyczące składników wystąpienia produktu zainstalowanego w ramach kont użytkowników innych niż bieżący użytkownik. Dostępne w Instalatorze Windows 3.0 lub nowszym.

 

Application-Only Functions

Nazwa Opis
MsiCollectUserInfo Przechowuje informacje o użytkowniku z kreatora instalacji.
MsiUseFeature Zwiększa liczbę użycia dla funkcji i wskazuje stan instalacji.
MsiUseFeatureEx Zwiększa liczbę użycia dla funkcji i wskazuje stan instalacji.
MsiGetProductCode Zwraca kod produktu przy użyciu kodu składnika.

 

Funkcje stanu systemu

Nazwa Opis
MsiEnumProducts Wylicza anonsowane produkty.
MsiEnumProductsEx Wylicza wszystkie wystąpienia reklamowanych lub zainstalowanych produktów w określonym kontekście. Dostępne w Instalatorze Windows 3.0 lub nowszym.
MsiEnumRelatedProducts Wylicza obecnie zainstalowane produkty o określonym kodzie uaktualniania.
MsiEnumFeatures Wylicza opublikowane funkcje.
msiEnumComponents Wylicza zainstalowane składniki.
MsiEnumComponentsEx Wylicza zainstalowane składniki na kontach użytkowników i kontekście instalacji. Instalatora Windows 4.5 i starszych: Nieobsługiwane.
MsiEnumClients Wylicza klientów zainstalowanego składnika.
MsiEnumClientsEx Wylicza klientów zainstalowanego składnika na kontach użytkowników i kontekście instalacji. Instalatora Windows 4.5 i starszych: Nieobsługiwane.
MsiEnumComponentQualifiers Wylicza anonsowane kwalifikatory dla składnika.
MsiQueryFeatureState Zwraca zainstalowany stan funkcji.
MsiQueryFeatureStateEx Zwraca stan zainstalowany dla funkcji produktu. Może wykonywać zapytania dotyczące funkcji wystąpienia produktu zainstalowanego w ramach kont użytkowników innych niż bieżący użytkownik. Dostępne w Instalatorze Windows 3.0 lub nowszym.
MsiQueryProductState Zwraca stan zainstalowany dla aplikacji lub pakietu aplikacji.
MsiGetFeatureUsage Zwraca metryki użycia dla funkcji.
MsiGetProductInfo Zwraca informacje o produkcie dla opublikowanych i zainstalowanych produktów.
MsiGetProductInfoEx Zwraca informacje o produkcie dla reklamowanych i zainstalowanych produktów. Może pobrać informacje o wystąpieniu produktu zainstalowanego na koncie użytkownika innym niż bieżący użytkownik. Dostępne w Instalatorze Windows 3.0 lub nowszym.
MsiGetUserInfo Zwraca zarejestrowane informacje o użytkowniku dla zainstalowanego produktu.

 

Funkcje zapytań produktów

Nazwa Opis
MsiOpenProduct Otwiera produkt do użycia z funkcjami, które uzyskują dostęp do bazy danych.
MsiOpenPackage Otwiera pakiet do użycia z funkcjami, które uzyskują dostęp do bazy danych.
MsiOpenPackageEx Otwiera pakiet do użycia z funkcjami, które uzyskują dostęp do bazy danych.
MsiIsProductElevated Sprawdza, czy produkt jest zainstalowany z podwyższonym poziomem uprawnień.
MsiGetProductInfoFromScript Zwraca informacje o produkcie dla pliku skryptu instalatora.
MsiGetProductProperty Pobiera właściwości w bazie danych produktu.
MsiGetShortcutTarget Sprawdza skrót i zwraca jego produkt, nazwę funkcji i składnik, jeśli jest dostępny.
MsiGetFeatureInfo Zwraca opisowe informacje dotyczące funkcji.
MsiVerifyPackage Sprawdza, czy określony plik jest pakietem instalacyjnym.

 

Funkcje stosowania poprawek

Nazwa Opis
MsiApplyPatch Wywołuje instalację i stosuje pakiet poprawek.
MsiEnumPatches Zwraca identyfikator GUID dla każdej poprawki zastosowanej do produktu oraz listę przekształceń z każdej poprawki, która ma zastosowanie do produktu.
MsiGetPatchInfo Zwraca informacje o poprawce.
MsiRemovePatches Odinstalowuje poprawkę z produktu. Dostępne w Instalatorze Windows 3.0.
MsiDeterminePatchSequence Określa najlepszą sekwencję aplikacji dla zestawu poprawek i produktu. Dostępne w Instalatorze Windows 3.0.
MsiApplyMultiplePatches Stosuje co najmniej jedną poprawkę do produktów. Dostępne w Instalatorze Windows 3.0.
MsiEnumPatchesEx Wylicza wszystkie poprawki stosowane dla produktu w określonym kontekście lub we wszystkich kontekstach. Dostępne w Instalatorze Windows 3.0.
msiGetPatchFileList Po podaniu listy plików msp ta funkcja pobiera listę plików, które mogą być aktualizowane przez poprawki dla targe. Dostępne w Instalatorze Windows 4.0.
MsiGetPatchInfoEx Wysyła zapytania dotyczące stosowania określonej poprawki do określonego produktu. Dostępne w Instalatorze Windows 3.0.
MsiExtractPatchXMLData Wyodrębnia informacje z poprawki. Dostępne w Instalatorze Windows 3.0.
MsiDetermineApplicablePatches Określa najlepszy zestaw poprawek wymaganych do zaktualizowania produktu lub zestawu produktów. Dostępne w Instalatorze Windows 3.0.

 

Funkcje zapytań dotyczących plików

Nazwa Opis
MsiGetFileHash Pobiera ścieżkę do pliku i zwraca 128-bitowy skrót tego pliku.
MsiGetFileSignatureInformation Pobiera ścieżkę do pliku, który został podpisany cyfrowo i zwraca certyfikat i skrót pliku.
MsiGetFileVersion Zwraca ciąg wersji i ciąg języka.

 

Funkcje zarządzania transakcjami

Nazwa Opis
MsiBeginTransaction Uruchamia przetwarzanie transakcji instalacji wielu pakietów i zwraca identyfikator transakcji. Ta funkcja jest dostępna począwszy od Instalatora Windows 4.5.
MsiJoinTransaction Żąda, aby Instalator Windows nawiązał bieżący proces jako właściciel transakcji instalując instalację wielu pakietów. Ta funkcja jest dostępna począwszy od Instalatora Windows 4.5.
MsiEndTransaction Zatwierdza lub przywraca wszystkie instalacje należące do transakcji. Ta funkcja jest dostępna począwszy od Instalatora Windows 4.5.

 

Funkcje bazy danych

Oprócz funkcji Instalatora Windows zidentyfikowanych w poprzednich tabelach można manipulować informacjami w bazie danych instalacji przy użyciu funkcji dostępu do bazy danych, które zostały opisane w sekcji Database Functions.

Struktury instalatora

Ponadto niektóre informacje w bazie danych instalacji są obsługiwane przy użyciu struktur opisanych w sekcji Struktury instalatora.