Zwracanie komunikatów o błędach z akcji niestandardowych

W tej sekcji opisano sposób wysyłania komunikatów z akcji niestandardowych, które faktycznie wykonują część instalacji przez wywołanie dynamicznej biblioteki linków lub skryptu. Należy pamiętać, że Niestandardowy Typ Akcji 19 wysyła jedynie określony komunikat o błędzie, zwraca niepowodzenie, a następnie kończy instalację. Niestandardowy typ akcji 19 nie wykonuje żadnej części instalacji.

Aby wysłać komunikat o błędzie z akcji niestandardowej korzystającej z biblioteki linków dynamicznych (DLL), należy wywołać akcję niestandardową MsiProcessMessage. Należy pamiętać, że akcje niestandardowe uruchamiane przez DoAction ControlEvent mogą wysyłać komunikaty za pomocą metody Message, ale nie mogą wysyłać komunikatu za pomocą MsiProcessMessage. W systemach starszych niż Windows Server 2003 akcje niestandardowe uruchamiane przez kontrolkę DoAction ControlEvent nie mogą wysyłać komunikatów za pomocą MsiProcessMessage lub metody Message. Aby uzyskać więcej informacji, zobacz Wysyłanie komunikatów przy użyciu MsiProcessMessage do Instalatora Windows.

Aby wyświetlić komunikat o błędzie z poziomu akcji niestandardowej przy użyciu biblioteki DLL

1. Akcja niestandardowa powinna wywołać MsiProcessMessage i przekazać parametry hInstall, eMessageTypei hRecord. Dojście do instalacji, niestandardowy typ akcji 19, może zostać dostarczone do akcji niestandardowej zgodnie z opisem w Uzyskiwanie dostępu do bieżącej sesji Instalatora z poziomu akcji niestandardowej lub z MsiOpenProduct lub MsiOpenPackage.
2. Parametr eMessageType powinien określać jeden z typów komunikatów wymienionych w MsiProcessMessage.
3. Parametr hRecord funkcjiMsiProcessMessage zależy od typu komunikatu. Zobacz wysyłanie komunikatów do Instalatora Windows przy użyciu MsiProcessMessage. Jeśli komunikat zawiera sformatowane dane, wprowadź komunikat do tabeli Błąd przy użyciu formatowania opisanego w Sformatowany.

Aby wysłać komunikat o błędzie z akcji niestandardowej korzystającej z Scripts, akcja niestandardowa może wywołać metodę Message obiektu Session.

Aby wyświetlić komunikat o błędzie z poziomu akcji niestandardowej przy użyciu skryptu

1. Akcja niestandardowa powinna wywołać metodę Message obiektu Session i przekazać parametr rodzaju oraz parametr rekordu .
2. Parametr rodzaju powinien określać jeden z typów komunikatów wymienionych w metodzie komunikatu .
3. rekord parametr metody Message zależy od typu komunikatu. Jeśli komunikat zawiera sformatowane dane, wprowadź go do tabeli Error zgodnie z formatowaniem opisanym w Sformatowany.

Akcje niestandardowe korzystające z plików wykonywalnych nie mogą wysłać komunikatu przez wywołanie metody msiProcessMessage lub Message, ponieważ nie mają możliwości uzyskania dojścia do instalacji.

Tematy pokrewne

wartości zwracane akcji niestandardowej