Informacje o domyślnej funkcji zwrotnej kolejki

Domyślna rutyna wywołania zwrotnego kolejki obsługuje powiadomienia wysyłane przez SetupCommitFileQueue w ogólny sposób. Korzystając z domyślnej procedury, uzyskasz gotowy interfejs użytkownika w celu utworzenia typowych okien dialogowych konfiguracji. Zaleca się użycie domyślnej procedury wywołania zwrotnego kolejki, zarówno w celu ułatwienia użycia, jak i zapewnienia spójnego wyglądu i zachowania okien dialogowych generowanych podczas instalacji.

Domyślna rutyna wywołania zwrotnego wymaga struktury kontekstu na potrzeby wewnętrznego przechowywania rekordów. Ponadto kolejka przekazuje dodatkowe informacje istotne dla bieżącego powiadomienia w postaci zestawu parametrów, Param1 i Param2.

Jeśli na przykład kolejka wysyła powiadomienie SPFILENOTIFY_NEEDMEDIA do domyślnej procedury wywołania zwrotnego, Param1 wskazuje na strukturę SOURCE_MEDIA zawierającą informacje o potrzebnym nośniku, a Param2 wskazuje na tablicę znaków, aby mogła odbierać nowe informacje o ścieżce od użytkownika.

Domyślna rutyna wywołania zwrotnego używa tych informacji, aby monitować użytkownika o wstawienie wymaganego nośnika źródłowego, określić nową ścieżkę, pominąć kopiowanie bieżącego pliku lub anulować bieżącą operację. Domyślna procedura zwrotna kolejki zwraca FILEOP_NEWPATH, FILEOP_DOIT, FILEOP_SKIP lub FILEOP_ABORT do kolejki, w zależności od tego, jaką akcję podjął użytkownik.

Aby uzyskać informacje na temat sposobu, w jaki domyślna procedura wywołania zwrotnego kolejki obsługuje każde powiadomienie kolejki, zobacz powiadomienia kolejki plików.

Aby uzyskać informacje na temat niestandardowych procedur wywołań zwrotnych kolejki, zobacz Tworzenie niestandardowej procedury wywołań zwrotnych kolejki.