GET_USER_TOKEN_VALUE

Valido per

Estrai e Replicat

Descrizione

Utilizzare la funzione GET_USER_TOKEN_VALUE per ottenere il valore di un token utente da un record trail. Non viene eseguita alcuna conversione del set di caratteri sul valore del token.

Sintassi

#include "usrdecs.h"

Buffer

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

Input

<token_name>

Puntatore a un buffer che rappresenta il nome di un token. Si presume che il nome del token sia codificato nel set di caratteri predefinito del sistema operativo che ospita l'istruzione Extract TABLE in cui è configurato il token. L'uscita utente prepara il nome del token nel set di caratteri specificato con SET_SESSION_CHARSET, ma lo converte nel set di caratteri del sistema operativo prima di recuperare il valore del token corrispondente.

<max_length>

La lunghezza massima del buffer token_name allocato per accettare qualsiasi valore di token risultante. Viene restituito come stringa terminata NULL.

Output

<token_value>

Puntatore a un buffer che rappresenta il valore restituito (se presente) di un token. Il valore del token viene passato all'uscita utente così com'è, senza alcuna conversione del set di caratteri.

<actual_length>

La lunghezza effettiva del valore del token restituito. Se viene trovato il token e non è presente alcun valore, viene restituito il valore 0.

<value_truncated>

Flag 0 o 1 che indica se il valore del token è stato troncato o meno. La troncatura si verifica se la lunghezza del nome della tabella più il terminatore nullo supera la lunghezza massima del buffer.

Valori restituiti

EXIT_FN_RET_INVALID_PARAM
EXIT_FN_RET_INVALID_CONTEXT
EXIT_FN_RET_TOKEN_NOT_FOUND
EXIT_FN_RET_OK