#include <security/pam_ext.h>
| void
            pam_prompt( | pam_handle_t *pamh, | 
| int style, | |
| char **response, | |
| const char *fmt, | |
| ... ); | 
| void
            pam_vprompt( | pam_handle_t *pamh, | 
| int style, | |
| char **response, | |
| const char *fmt, | |
| va_list args ); | 
The pam_prompt function
      constructs a message from the specified format string and
      arguments and passes it to the conversation function as set
      by the service. Upon successful return, response is set to point to a
      string returned from the conversation function. This string
      is allocated on heap and should be freed.
Memory buffer error.
Conversation failure.
Transaction was successful created.
System error.
The pam_prompt and
      pam_vprompt functions are
      Linux-PAM extensions.
| 
                  See Linux-PAM copyright notice for more information.
                 |