A visszahívási környezet inicializálása és megszüntetése

Mielőtt az alapértelmezett üzenetsor-visszahívási rutin használható lenne, inicializálni kell. Ez akkor történhet, ha megadják visszahívási rutinként egy fájlsor véglegesítésekor, vagy ha meghívják egy egyéni visszahívási rutinból.

A SetupInitDefaultQueueCallback függvény létrehozza az alapértelmezett üzenetsor-visszahívási rutin által használt környezetstruktúrát. Üres mutatót ad vissza ehhez a struktúrához. Ez a struktúra alapvető fontosságú az alapértelmezett visszahívási rutin működéséhez, és át kell adni a visszahívási rutinnak. Ezt úgy teheti meg, hogy a SetupCommitFileQueuehívásában az üres mutatót adja meg környezetként, vagy ha az üres mutatót környezeti paraméterként adja meg a SetupDefaultQueueCallback egyéni visszahívási rutinból való meghívásakor. Ezt a kontextus struktúrát a telepítő alkalmazás nem módosíthatja és nem hivatkozhat rá.

A SetupInitDefaultQueueCallbackEx függvény inicializálja az alapértelmezett üzenetsor-visszahívási rutin kontextusát is, de egy második ablakot ad meg a hívó által megadott állapotüzenet fogadásához minden alkalommal, amikor az üzenetsor értesítést küld. Ez lehetővé teszi az alapértelmezett lemezmegjelenítési és hibapanelek használatát, valamint egy folyamatjelző sáv beágyazását egy második ablakba, például egy telepítővarázsló lapjára.

Függetlenül attól, hogy az alapértelmezett várósor visszahívási rutin által használt környezetet a SetupInitDefaultQueueCallback vagy a SetupInitDefaultQueueCallbackExsegítségével inicializálta, miután az ütemezett műveletek feldolgozása befejeződött, hívja meg a SetupTermDefaultQueueCallback függvényt annak érdekében, hogy felszabadítsa a környezet inicializálásakor lefoglalt erőforrásokat.