Tworzenie procedury wywołania zwrotnego gabinetu

Ponieważ interfejs API instalacji nie dostarcza domyślnej procedury wywołania zwrotnego archiwum, należy podać procedurę. Procedura wywołania zwrotnego wymagana przez funkcję SetupIterateCabinet musi mieć taką samą formę jak ta wskazywana przez FileCallback.

Poniżej znajduje się składnia, której SetupIterateCabinet używa, aby wysłać powiadomienie do procedury wywołania zwrotnego.

MsgHandler(          //the specified callback routine
    Context,         //context used by the callback routine
    Notification,    //cabinet notification
    Param1,          //additional notification information
    Param2           //additional notification information
);

Parametr Context jest wskaźnikiem typu void do zmiennej kontekstowej lub struktury, która może być używana przez procedurę obsługi zdarzeń do przechowywania informacji, które muszą być zachowane między kolejnymi wywołaniami procedury obsługi zdarzeń.

Implementacja tego kontekstu jest określana przez rutynę zwrotną i nigdy nie jest odwoływana ani zmieniana przez SetupIterateCabinet.

Parametr Notification jest niepodpisaną liczbą całkowitą i będzie jedną z następujących wartości.

Powiadomienie Opis
SPFILENOTIFY_FILEEXTRACTED Plik został wyodrębniony z szafki.
SPFILENOTIFY_FILEINCABINET W szafie napotkano plik.
SPFILENOTIFY_NEEDNEWCABINET Bieżący plik jest kontynuowany w następnej szafce.

 

Dwa ostatnie parametry, Param1 i Param2, są również niepodpisane liczby całkowite i zawierają dodatkowe informacje istotne dla powiadomienia. Aby uzyskać więcej informacji na temat powiadomień wysyłanych przez SetupIterateCabinet, zobacz Cabinet File Notifications.

Rutyna SP_FILE_NOTIFY_CALLBACK zwraca niepodpisaną liczbę całkowitą. W zależności od powiadomienia, procedura wywołania zwrotnego Cabinet powinna zwrócić jedną z następujących wartości.

W przypadku powiadomienia SPFILENOTIFY_FILEINCABINET SetupIterateCabinet oczekuje, że jedna z następujących wartości zostanie zwrócona przez procedurę wywołania zwrotnego.

Wartość Znaczenie
FILEOP_ABORT Przerwanie przetwarzania szafy sterowniczej.
FILEOP_DOIT Wyodrębnij bieżący plik.
FILEOP_SKIP Pomiń bieżący plik.

 

W przypadku powiadomień SPFILENOTIFY_NEEDNEWCABINET i SPFILENOTIFY_FILEEXTRACTED SetupIterateCabinet oczekuje, że jedna z następujących wartości zostanie zwrócona przez procedurę wywołania zwrotnego.

Wartość Znaczenie
BRAK_BŁĘDU Nie napotkano błędu, można kontynuować przetwarzanie szafy.
ERROR_XXX Wystąpił błąd określonego typu. Funkcja SetupIterateCabinet zwróci false, a określony kod błędu zostanie zwrócony przez wywołanie polecenia GetLastError.

 

Jeśli procedura wywołania zwrotnego zwróci FILEOP_DOIT, należy również podać pełną ścieżkę docelową. Aby uzyskać więcej informacji, zobacz SPFILENOTIFY_FILEINCABINET.

 

 

  • Last updated on