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.
- SUCCESS or one of the following error codes:
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. |