PutContext

Définit la valeur du nom donné dans les propriétés « Contexte ». S'il y a une valeur existante pour l'entité identifiée par le nom, elle est remplacée. Les propriétés de contexte incluent les constantes suivantes : identifiant du compte, mot de passe du compte, nom du service, clé du service et identifiant de la requête.

Syntaxe

Version ASCII
int putContext(Message* message,const char* name,
const char* value) 
Version Unicode
int putContext(Message* message,const UChar* name,
const UChar* value) 

Paramètres

  • Message : message auquel cette fonction s'applique
  • Name : nom avec lequel la valeur spécifiée doit être associée
  • Value : valeur à associer au nom spécifié

Résultats

Renvoie 0 (en cas de succès) ou un code d'erreur.

Exemple

Version ASCII
int nRet;
Message* message = createMessage();
nRet = putContext( message, "account.id", "user1") ; 
Version 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);