Akce InstallValidate
Akce InstallValidate ověřuje, že všechny svazky , ke kterým náklady byly přiřazeny, dostatek místa pro instalaci. Akce InstallValidate ukončí instalaci závažnou chybou, pokud některý svazek nemá málo místa na disku.
Akce InstallValidate také upozorní uživatele, pokud jeden nebo více souborů, které mají být přepsány nebo odebrány, jsou aktuálně používány aktivním procesem. Další informace naleznete v tématu Restartování systému.
Omezení posloupnosti
Akce CostFinalize a všechny sekvence uživatelského rozhraní, které uživateli umožňují upravovat stavy výběru nebo adresáře, by se měly sekvencovat před akcí InstallValidate.
vlastní akce, které mění stav instalace funkcí nebo součástí, musí být sekvencovány před akcí InstallValidate.
Zprávy ActionData
Neexistují žádné zprávy ActionData.
Poznámky
Při pokusu uživatele o zahájení kopírování souborů by obvykle měla posloupnost dřívějšího dialogového okna uživatelského rozhraní provést stejné ověření jako akce InstallValidate. Tato posloupnost dialogového okna uživatelského rozhraní by měla obsahovat dialogové okno Nedostatek místa na disku, pokud vybrané svazky nemají dostatek místa pro instalaci. Dialogová okna uživatelského rozhraní by se měla vytvořit tak, aby uživatel nemohl pokračovat v instalaci, pokud není dostatek místa na disku. V případě tiché instalace neexistuje žádné uživatelské rozhraní a akce InstallValidate ukončí instalaci, pokud není dostatek místa na disku. Pokud je protokolování povolené, zaznamená se v souboru protokolu příčina předčasného ukončení.
Položka se přidá do interní tabulky FilesInUse, pokud se nějaký soubor přepíše nebo odebere, když je otevřen pro provádění nebo úpravy jakýmkoli procesem během souboru náklady. Tabulka FilesInUse obsahuje sloupce pro název a úplnou cestu k souboru. Když se spustí akce InstallValidate, instalační program odešle dotaz na tabulku FilesInUse pro položky a určí název procesu pomocí souboru. Akce InstallValidate přidá jeden záznam do tabulky ListBox tabulky uživatelského rozhraní pro každý jedinečný proces identifikovaný tímto dotazem. Záznam obsahuje v každém sloupci následující hodnoty:
vlastnosti: FileInUseProcess
hodnota: Název procesu
Textové: Text obsažený v titulku hlavního okna procesu
Akce InstallValidate pak zobrazí dialogové okno Soubory v použití. V tomto dialogovém okně se zobrazí procesy, které musí být vypnuté, aby se zabránilo požadavku na restartování systému pro nahrazení souborů, které se používají.
Akce InstallValidate se dotazuje na tabulku dialogového okna pro vytvořené dialogové okno s rezervovaným názvem FilesInUse a zobrazí se. Toto dialogové okno musí obsahovat ListBox ovládací prvek, který je vázán na vlastnost s názvem FileInUseProcess. Podle konvence má toto dialogové okno tlačítko Exit, Opakovatnebo Ignorovat tlačítko, ale toto je až na autor uživatelského rozhraní. Každé tlačítko by mělo být svázané s EndDialog ControlEvent v tabulce ControlE vent. Akce InstallValidate reaguje následujícím způsobem na hodnotu vrácenou DoAction ControlEvent, jak určuje jeden z těchto EndDialog argumenty přidružené k tlačítku nabízenému uživatelem:
opakovat: Všechny hodnoty přidané do tabulky ListBox se vymažou a celý soubor náklady procedura se opakuje a znovu zkontroluje soubory, které se stále používají. Pokud se jeden nebo více procesů stále identifikuje jako použití souborů k přepsání nebo odstranění, proces se opakuje; Jinak InstallValidate vrátí ovládací prvek instalačnímu programu se stavem msiDoActionStatusSuccess.
ukončení: Akce InstallValidate okamžitě vrátí ovládací prvek instalačnímu programu se stavem msiDoActionStatusUserExit. Tím se instalace ukončí.
Jakákoli jiná návratová hodnota: Akce InstallValidate okamžitě vrátí ovládací prvek instalačnímu programu se stavem msiDoActionStatusSuccess. V takovém případě, protože jeden nebo více souborů se stále používá, následující InstallFiles nebo InstallAdminPackage akce musí být při restartování systému nahrazeny nebo odstraněny.
Pokud v databázi není žádná ListBox tabulka, InstallValidate se bez chyby ukončí bez chyby.
Středník je oddělovač seznamu pro transformace, zdroje a opravy a neměl by být použit v těchto názvech nebo cestách.
Soubory označené jen pro čtení v umístění jen pro čtení se nikdy nepovažují za používané instalačním programem.
Výchozí dialogové okno Nedostatek místa na disku obsahující Přerušení a Tlačítka opakovat se uživateli zobrazí, pokud je úroveň uživatelského rozhraní základní.