Beställning av köåtagande

När funktionen SetupCommitFileQueue checkar in filkön bearbetas filåtgärderna i följande ordning: åtgärder för filborttagning, sedan filbytesåtgärder och slutligen filkopieringsåtgärder. Följande disposition illustrerar livscykeln för en kös åtagandeprocess.

 

• starta borttagningsunderfrågan
  • starta en filborttagningsåtgärd <– upprepa för varje
  • slutför en filborttagningsåtgärd <– filborttagning i kö
• slutför underfrågan ta bort

• starta underfrågan byt namn
  • starta en filbytesåtgärd <– upprepa för varje
  • slutför en filborttagningsåtgärd <– filbyte i kö
• slutför underfrågan byt namn

• starta kopieringsunderfrågan
  • starta en filkopieringsåtgärd <– upprepa för varje
  • slutför en filkopieringsåtgärd <– filkopiering i kö
  • slutför kopieringsunderfrågan
• slutför kön

 

Vid varje steg, eller om ett fel inträffar, skickar funktionen SetupCommitFileQueue ett meddelande till återanropsrutinen. Återanropsrutinen kan använda den information som skickas av kön för att spåra installationsframställningen och vid behov interagera med användaren.

Om en filkopieringsåtgärd till exempel behövde en källfil som inte var tillgänglig på den aktuella sökvägen skulle SetupCommitFileQueue skicka ett SPFILENOTIFY_NEEDMEDIA meddelande till återanropsrutinen, tillsammans med information om den fil och det media som krävs. Återanropsrutinen kan använda den här informationen för att generera en dialogruta som uppmanar användaren att infoga nästa disk genom att anropa SetupPromptForDisk

En standardrutin för köåteranrop, SetupDefaultQueueCallback, ingår i installations-API:et. Den här rutinen hanterar kömeddelanden och genererar feldialogrutor och förloppsstaplar för installationen. Du kan använda standardrutinen för köåteranrop som den är, eller skriva en filterrutin för återanrop för att hantera en delmängd av meddelandena och skicka de andra vidare till standardrutinen för köåteranrop.

Om ingen av funktionerna i återanropsrutinen passar dina behov kan du skriva en fristående anpassad återanropsrutin som inte anropar standardrutinen för köåteranrop.

Mer information om köåteranropsrutiner finns i standardrutin för köåteranropoch Skapa en anpassad köåteranropsrutin.