Rückgabewerte für benutzerdefinierte Aktionen

  • Artikel

Wenn die Rückgabeverarbeitungsoption msidbCustomActionTypeContinue nicht festgelegt ist, muss die benutzerdefinierte Aktion einen Integer-Statuscode zurückgeben, wie in der folgenden Tabelle gezeigt.

Rückgabewert BESCHREIBUNG
ERROR_FUNCTION_NOT_CALLED Aktion wurde nicht ausgeführt.
ERROR_SUCCESS Aktionen wurden erfolgreich abgeschlossen.
ERROR_INSTALL_USEREXIT Installer wurde vorzeitig abgebrochen.
ERROR_INSTALL_FAILURE Ein nicht behebbarer Fehler ist aufgetreten.
ERROR_NO_MORE_ITEMS Verbleibende Aktionen überspringen, kein Fehler.

 

Beachten Sie, dass benutzerdefinierte Aktionen, die ausführbare Dateien sind, den Wert „0“ zurückgeben müssen, um als erfolgreich zu gelten. Das Installationsprogramm behandelt jeden anderen Rückgabewert als Fehler. Um Rückgabewerte zu ignorieren, legen Sie das Bitflag msidbCustomActionTypeContinue im Feld Typ der Tabelle CustomAction fest.

Weitere Informationen zur Option msidbCustomActionTypeContinue und zu anderen Rückgabeverarbeitungsoptionen finden Sie unter Optionen für die Rückgabeverarbeitung von benutzerdefinierten Aktionen.

Beachten Sie, dass Windows Installer die Rückgabewerte aller Aktionen übersetzt, wenn der Rückgabewert in die Protokolldatei geschrieben wird. Wenn der Rückgabewert der Aktion beispielsweise in der Protokolldatei als „1“ angezeigt wird, bedeutet dies, dass die Aktion ERROR_SUCCESS zurückgab. Weitere Informationen zu dieser Übersetzung finden Sie unter Protokollierung von Aktionsrückgabewerten.

Fehlercodes

Protokollierung von Aktionsrückgabewerten