GET_USER_TOKEN_VALUE

Válido para

Extraer y Replicat

Descripción

Utilice la función GET_USER_TOKEN_VALUE para obtener el valor de un token de usuario de un registro de pista. No se realiza ninguna conversión de juego de caracteres en el valor de token.

Sintaxis

#include "usrdecs.h"

Buffer

typedef struct
{
char *token_name;
char *token_value;
long max_length;
long actual_length;
short value_truncated;
} token_value_def;

Entrada

<token_name>

Puntero a un buffer que representa el nombre de un token. Se supone que el nombre del token está codificado en el juego de caracteres por defecto del sistema operativo que aloja la sentencia Extract TABLE en la que se configura el token. La salida de usuario prepara el nombre del token en el juego de caracteres especificado con SET_SESSION_CHARSET, pero lo convierte de nuevo en el juego de caracteres del sistema operativo antes de recuperar el valor del token coincidente.

<max_length>

Longitud máxima del buffer token_name asignado para aceptar cualquier valor de token resultante. Se devuelve como una cadena terminada NULL.

Salida

<token_value>

Un puntero a un buffer que representa el valor de retorno (si lo hay) de un token. El valor de token se devuelve a la salida de usuario tal cual, sin ninguna conversión de juego de caracteres.

<actual_length>

Longitud real del valor de token que se devuelve. Se devuelve un valor 0 si se encuentra el token y no hay ningún valor presente.

<value_truncated>

Indicador de 0 o 1 que indica si el valor de token se truncó o no. El truncamiento se produce si la longitud del nombre de la tabla más el terminador nulo supera la longitud máxima del buffer.

Valores devueltos

EXIT_FN_RET_INVALID_PARAM
EXIT_FN_RET_INVALID_CONTEXT
EXIT_FN_RET_TOKEN_NOT_FOUND
EXIT_FN_RET_OK