SCF_strerror(3SMARTCARD) Smartcard Library Functions SCF_strerror(3SMARTCARD)NAMESCF_strerror - get a string describing a status code
SYNOPSIS
cc [ flag... ] file... -lsmartcard [ library...]
#include <smartcard/scf.h>
const char *SCF_strerror(SCF_Status_t error);
PARAMETERS
error A value returned from a smartcard SCF function call. A
list of all current codes is contained in <smart‐
card/scf.h>
DESCRIPTION
The SCF_strerror() function provides a mechanism for generating a brief
message that describes each SCF_Status_t error code. An application
might use the message when displaying or logging errors.
The string returned by the function does not contain any newline char‐
acters. Returned strings must not be modified or freed by the caller.
RETURN VALUES
A pointer to a valid string is always returned. If the provided error
is not a valid SCF error code, a string is returned stating that the
error code is unknown. A null pointer is never returned.
EXAMPLES
Example 1: Report a fatal error.
SCF_Status_t status;
SCF_Session_t mySession;
status = SCF_Session_getSession(&mySession);
if (status != SCF_STATUS_SUCCESS) {
printf("Smartcard startup error: %s\n", SCF_strerror(status));
exit(1);
}
/* ... */
USAGE
Messages returned from SCF_strerror() are in the native language speci‐
fied by the LC_MESSAGES locale category; see setlocale(3C). The C
locale is used if the native strings could not be loaded.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Evolving │
├─────────────────────────────┼─────────────────────────────┤
│MT-Level │MT-Safe │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOlibsmartcard(3LIB), SCF_Session_getSession(3SMARTCARD), strerror(3C),
attributes(5)SunOS 5.10 14 May 2002 SCF_strerror(3SMARTCARD)