[][src]Type Definition wcxhead::tChangeVolProc

type tChangeVolProc = extern "stdcall" fn(ArcName: *mut char, Mode: c_int) -> c_int;

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:

ConstantValueDescription
PK_VOL_ASK0Ask user for location of next volume
PK_VOL_NOTIFY1Notify 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.