PutOption

Définit la valeur du nom donné dans les propriétés « Option ». S'il y a une valeur existante pour l'entité identifiée par le nom, elle est remplacée. Les propriétés Option sont les options d'exécution spécifiques au service.

Syntaxe

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

Paramètres

  • Message - le message auquel cette fonction s'applique
  • Nom - avec lequel la valeur spécifiée doit être associée.
  • Valeur - à associer avec le 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 = putOption( message, "OutputCasing", "M"); 
Version Unicode
int nRet; 
Message* message; 
// construct 16-bit string 
UChar option[32]; 
char* optionString="OutputCasing"; 

UChar optionValue[32]; 
char* optionValueString="M"; 

u_charsToUChars(optionString,	option,	strlen(optionString)); 
option[ strlen(optionString)]=0; 

u_charsToUChars(optionValueString,	optionValue, 
strlen(optionValueString)); 
optionValue [ strlen(optionValueString)]=0;	

message = createMessage(); 
nRet = putOption( message,	option, optionValue);