Sun OpenSSO Enterprise 8.0 C API Reference for Application and Web Policy Agent Developers

am_auth_text_input_callback_t

Retrieves generic textual information.

Details

am_auth_text_input_callback_t is a C implementation of the Java javax.security.auth.callback.TextInputCallback class.

Syntax

#include "am_auth.h"
typedef struct am_auth_text_input_callback_info {
    const char *prompt;
    const char *default_text;
    const char *response; /* text */
} am_auth_text_input_callback_t;

Members

prompt

Pointer to the user's prompt.

default_text

Pointer to the default text to be displayed with the user prompt.

response

Pointer to the text submitted back to OpenSSO Enterprise.

Memory Concerns

Memory is allocated by am_auth_login(), and freed by calling am_auth_destroy_auth_context(). Memory for the response must be allocated and freed by the caller.