C++ SDK

◆ ShowMessage()

static int CApplicationAPI::ShowMessage ( LpError  lpError,
LPCTSTR  lpszMessage,
int  nButtons,
BOOL  bWaitForFeedback,
BOOL  bShowApplication,
int &  nUserFeedback,
DWORD  dwMaxTime = DEFAULT_MAX_TIME 
)
static

The function shows a dialog with a specified message.

Parameters
lpErrorAdditional error information returned from Drive.
lpszMessageText of the message to show.
nButtonsType of used buttons.
  • 1 - MbOk
  • 2 - MbOkCancel
  • 3 - MbYesNo
bWaitForFeedbackFlag determining whether Drive returns reply before user click the button.
true - Drive will return reply after user click the button
false - Drive will return reply immediately.
nUserFeedbacknUserFeedback informs which button clicked.
101 - Cancel/No button
201 - Ok/Yes button
dwMaxTimeMaximum time (in milliseconds) function can take. If dwMaxTime=0 function execution is not time limited.
bShowApplicationFlag determining whether Drive should be brought to foreground automatically.
true - Drive will be brought to foreground.
false - Drive will stay in background.
Returns
1 if successful, other value otherwise.

ShowMessage shows dialog over full device screen with take message.

Possible error codes returned from Drive are:

  • 0 - Function not succeeded.
  • 1 - Function succeeded.
  • 2 - Drive not succeeded.
  • 3 - Function reached timeout.