PutOption

Legt den Wert für den angegebenen Namen in den „Optionseigenschaften“ fest. Wenn für die durch den Namen identifizierte Entität bereits ein Wert vorhanden ist, wird dieser ersetzt. Bei Optionseigenschaften handelt es sich um die dienstspezifischen Laufzeitoptionen.

Syntax

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

Parameter

  • Message: Dies ist die Nachricht, auf die diese Funktion angewendet wird.
  • Name: Dies ist der Name, dem der angegebene Wert zugeordnet werden soll.
  • Value: Dies ist der Wert, der dem angegebenen Namen zugeordnet werden soll.

Ergebnisse

Gibt bei Erfolg 0, ansonsten den Fehlercode zurück.

Beispiel

ASCII-Version
int nRet;
Message* message = createMessage();
nRet = putOption( message, "OutputCasing", "M"); 
Unicode-Version
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);