TChangeVolProc

From TotalcmdWiki
Jump to: navigation, search

tChangeValueProc is a typedef of the function that asks the user to change volume.

 typedef int (__stdcall *tChangeVolProc)(char *ArcName, int Mode);

Description

SetChangeVolProc has provided you with a pointer to a function with this declaration. When you want the user to be asked about changing volume, call this function with appropriate parameters. The function itself is part of Totalcmd - you only specify the question. Totalcmd then asks the user, and you get the answer as the result of the call to this function. If the user has aborted the operation, the function returns zero.

  • ArcName specifies the filename of the archive that you are processing, and will receive the name of the next volume.
  • Set Mode to one of the following values, according to what you want Totalcmd to ask the user:
Constant Value Description
PK_VOL_ASK 0 Ask user for location of next volume
PK_VOL_NOTIFY 1 Notify app that next volume will be unpacked

Note

The keyword or constant __stdcall must be set according to the compiler that you will use to make the library. For example, this is STDCALL for cygwin and __stdcall for MSC.


Back to Packer plugins developer guide Back to SetChangeVolProc