Getlong, Getlongxy

OllyDbg Plugin API

Getlong, Getlongxy

Functions display dialog allowing user to enter 8-, 16- or 32-bit integer number in any of 3 formats: hexadecimal, decimal unsigned or decimal signed, or (if bit DIA_HEXONLY is set) in hexadecimal format only. Optional checkboxes "Entire block" and "Aligned search" are controlled by bits DIA_ASKGLOBAL and DIA_ALIGNED and control global flags globalsearch and alignedsearch. Return 0 on success and -1 if error occured or user cancelled action. Function Getlongxy additionally contains the preferred screen coordinates of the bottom left point of the dialog window.

int Getlong(char *title,ulong *data,int datasize,char letter,int mode);

int Getlongxy(char *title,ulong *data,int datasize,char letter,int mode,int x,int y);

Parameters:

title - title of dialog box;

data - pointer to 32-bit buffer containing initial value of integer number. On return, buffer contains entered value. If user cancels action, value remains unchanged;

datasize - size of integer number in bytes (1, 2 or 4). Note that dependless on datasize, buffer pointed to by data nust be 32 bits (4 bytes) long;

letter - first character to be entered in default control, or 0 if there is no character. Useful if function is called as a reaction on a character entered by user;

mode - combination of DIA_xxx bits specifying additional Getlong features:

DIA_HEXONLY hide decimal input windows
DIA_ASKGLOBAL display checkbox "Entire block" that controls global search flag. Actual state of this flag is returned by call to Plugingetvalue(VAL_GLOBALSEARCH)
DIA_ALIGNED display checkbox "Aligned search" that controls aligned search flag. Actual state of this flag is returned by call to Plugingetvalue(VAL_ALIGNEDSEARCH)

x - absolute X screen coordinate, in pixels, of the bottom left corner of the dialog window. If necessary, dialog will automatically adjust its position so that it remains visible;

y - absolute Y screen coordinate, in pixels, of the bottom left corner of the dialog window.

See also: Getregxy, Getline, Getfloat, Getfloat10, Getmmx, Get3dnow, Gettableselectionxy