RnaUICallbackDialog


DWORD
WINAPI RnaUICallbackDialog(HANDLE hConn,
   LPSTR lpszLocList, DWORD dwType, BOOL fOptional,
   LPINT lpuIndex, LPSTR lpszSelectLocation, UINT cbBuff)

This function is called by the initiator-type SMM to display a common callback dialog box. The dialog box allows the end-user to select the callback location or to enter a callback phone number, depending on the callback type.

hConn

The RNA connection handle.

lpszLocList

An address to a buffer containing a list of null-terminated strings for the callback locations. The list is terminated by an extra null character after the last location.

dwType

A DWORD value indicating one of the following callback types.

CALLBACK_SECURE

The RNA client can choose from the list of callback locations only.

CALLBACK_CONVENIENCE

The RNA client can choose from the list of the callback location or enter a callback phone number.

fOptional

A boolean indicating whether a callback is optional

lpuIndex

An address to an integer buffer to receive the index to the selected callback location in the 'lpszLocList' list. For CALLBACK_CONVENIENCE, the value is -1 if a phone number is entered.

lpszSelectLocation

An address to a buffer to receive the selected callback location or the phone number entered in the CALLBACK_CONVENIENCE type.

cbBuff

The size in bytes of the 'lpszSelectLocation' buffer.

ERROR_INVALID_HANDLE

The RNA connection handle is invalid.

ERROR_NO_RESPONSES

The end-user cancels the dialog box. In case the callback is optional, this means the end-user does not want the callback.