Initiera och terminera callback-kontexten

Innan standardrutinen för köåteranrop kan användas, antingen genom att ange den som återanropsrutin vid incheckning av en filkö eller genom att anropa den från en anpassad återanropsrutin, måste den initieras.

Funktionen SetupInitDefaultQueueCallback skapar den kontextstruktur som används av standardrutinen för köåteranrop. Den returnerar en void-pekare till den strukturen. Den här strukturen är viktig för standardåteranropsrutinens åtgärd och måste skickas till återanropsrutinen. Det kan du göra antingen genom att ange tomrumspekaren som kontext i ett anrop till SetupCommitFileQueue, eller genom att ange tomrumspekaren som kontextparameter när du anropar SetupDefaultQueueCallback från en anpassad återanropsrutin. Den här kontextstrukturen får inte ändras eller refereras av installationsprogrammet.

Funktionen SetupInitDefaultQueueCallbackEx initierar också en kontext för standardrutinen för köåteranrop, men den anger ett andra fönster för att ta emot ett meddelande som anges av anroparen varje gång kön skickar ett meddelande. På så sätt kan du använda standarddialogrutorna för frågor och fel på diskar och bädda in ett förloppsfält i ett andra fönster, till exempel på en sida i installationsguiden.

Oavsett om du initierade kontexten som används av standardrutinen för köåteranrop med SetupInitDefaultQueueCallback eller SetupInitDefaultQueueCallbackEx, anropar du SetupTermDefaultQueueCallback för att frigöra de resurser som allokerades när kontextstrukturen initialiserades.