PromptPopup

int PromptPopup (char title[], char message[], char responseBuffer[], int maxResponseLength);

Purpose

Displays a prompt message in a dialog box and waits for the user to enter a reply.

Parameters

Input
Name Type Description
title string Title of the dialog box.
message string Message to display in the dialog box.

To display a multi-line message, embed newline characters (\n) in the message string.
maxResponseLength integer Maximum number of bytes the user is allowed to enter.

The responseBuffer must be large enough to contain all of the user input plus one ASCII NUL byte.
Output
Name Type Description
responseBuffer string Buffer in which to store the user response.

The buffer must be large enough to hold maxResponseLength bytes plus one ASCII NUL byte.

Return Value

Name Type Description
status integer Return value indicating whether the function was successful. A negative number indicates that an error occurred.

Code Error Message String
xx Success