TipcMtSetDeliveryMode

Name

TipcMtSetDeliveryMode — set the delivery mode of a message type

Synopsis

T_BOOL TipcMtSetDeliveryMode(mt, delivery_mode) 
T_IPC_MT mt; 
T_IPC_DELIVERY_MODE delivery_mode; 

Arguments

mt — message type to set delivery mode for

delivery_mode — message type delivery mode (T_IPC_DELIVERY_BEST_EFFORT, T_IPC_DELIVERY_ORDERED, T_IPC_DELIVERY_SOME, or T_IPC_DELIVERY_ALL)

Return Values

TRUE if the delivery mode was successfully set for the message type, FALSE otherwise.

Diagnostics

If TipcMtSetDeliveryMode fails, it returns FALSE and sets the global SmartSockets error number to one of:

Description

TipcMtSetDeliveryMode sets the delivery mode of a message type. The delivery mode of a message type is used as the default delivery mode for messages of this type. See TipcMtGetDeliveryMode for more information on message type delivery modes.

Caution

None

See Also

TipcMsgSetDeliveryMode, TipcMtGetDeliveryMode

Examples

This example sets the delivery mode of the NUMERIC_DATA message type to T_IPC_DELIVERY_ALL:

T_IPC_MT mt; 
 
mt = TipcMtLookup("numeric_data"); 
if (mt == NULL) { 
  return;  /* error */ 
} 
if (!TipcMtSetDeliveryMode(mt, T_IPC_DELIVERY_ALL)) { 
  return;  /* error */ 
} 
 
/* After this point, all newly-created NUMERIC_DATA messages will have a default delivery mode 
of T_IPC_DELIVERY_ALL. */