PutContext

Define el valor de un nombre dado en las propiedades de "contexto". Si hay un valor ya existente que esté presente para la entidad identificada por el nombre, ese valor es reemplazado. Las propiedades del contexto incluyen las siguientes constantes: ID de la cuenta, contraseña de la cuenta, el nombre del servicio, clave del servicio e ID de la petición.

Sintaxis

Versión ASCII
int putContext(Message* message,const char* name,
const char* value) 
Versión Unicode
int putContext(Message* message,const UChar* name,
const UChar* value) 

El json en el POST es opcional; solo se requiere si la consulta SQL utiliza parámetros vinculados.

  • Message: el mensaje al que se aplica esta función
  • Name: el nombre con el que debe relacionarse el valor especificado
  • Value: el valor relacionado con el nombre especificado

Resultados

Arroja 0 (en caso de éxito) o un código de error.

Arroja la cantidad de características actualizadas de manera exitosa en una tabla con nombre asignado en el repositorio.

Versión ASCII
int nRet;
Message* message = createMessage();
nRet = putContext( message, "account.id", "user1") ; 
Versión Unicode
int nRet; 
Message* message; 
// construct 16-bit string 
UChar accountID[32]; 
char* account="account.id";
UChar accountIDValue[32]; 
char* accountValue="user1"; 
u_charsToUChars(account,	accountID,	strlen(account)); 
accountID [ strlen(account)]=0; 
u_charsToUChars(accountValue,	accountIDValue,	strlen(accountValue)); 
accountIDValue [ strlen(accountValue)]=0;	
message = createMessage(); 
nRet = putContext( message,	accountID, accountIDValue);