Inicjowanie i zakończenie kontekstu wywołania zwrotnego

Zanim domyślna procedura wywołania zwrotnego kolejki będzie mogła zostać użyta, czy to poprzez określenie jej jako procedury wywołania zwrotnego podczas zatwierdzania kolejki plików, czy przez wywołanie jej z niestandardowej procedury wywołania zwrotnego, musi zostać zainicjalizowana.

Funkcja SetupInitDefaultQueueCallback tworzy strukturę kontekstu używaną przez domyślną procedurę obsługi wywołania zwrotnego kolejki. Zwraca wskaźnik void do tej struktury. Ta struktura jest niezbędna dla domyślnej procedury wywołania zwrotnego i musi zostać przekazana do procedury wywołania zwrotnego. Można to zrobić, określając wskaźnik void jako kontekst w wywołaniu SetupCommitFileQueuelub określając wskaźnik void jako parametr kontekstu podczas wywoływania SetupDefaultQueueCallback z niestandardowej procedury wywołania zwrotnego. Ta struktura kontekstu nie może być zmieniana ani przywoływane przez aplikację instalatora.

Funkcja SetupInitDefaultQueueCallbackEx inicjuje również kontekst dla domyślnej procedury wywołania zwrotnego kolejki, ale dodatkowo określa drugie okno do odbierania komunikatu o postępie określonym przez obiekt wywołujący za każdym razem, gdy kolejka wysyła powiadomienie. Dzięki temu można użyć domyślnych okien dialogowych monitowania i błędu dysku, a także osadzić pasek postępu w drugim oknie, na przykład na stronie kreatora instalacji.

Bez względu na to, czy zainicjowano kontekst używany przez domyślną procedurę wywołania zwrotnego kolejki z SetupInitDefaultQueueCallback czy SetupInitDefaultQueueCallbackEx, po zakończeniu przetwarzania operacji w kolejce wywołaj SetupTermDefaultQueueCallback, aby zwolnić zasoby przydzielone podczas inicjowania struktury kontekstu.