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. |