TipcMtSetPriorityUnknown

Name

TipcMtSetPriorityUnknown — set the priority of a message type to unknown

Synopsis

T_BOOL TipcMtSetPriorityUnknown(mt) 
T_IPC_MT mt; 

Arguments

mt — message type to set priority to unknown

Return Values

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

Diagnostics

If TipcMtSetPriorityUnknown fails, it returns FALSE and sets the global SmartSockets error number to:

Description

TipcMtSetPriorityUnknown sets the priority of a message type to unknown. This can also be thought of as unsetting the priority. The priority of a message type, if set, is used as the default priority for messages of this type. See TipcMtGetPriority for more information on message type priorities.

Use the function TipcMtSetPriority to set the message type priority to a specific value.

Caution

None

See Also

TipcMtGetPriority, TipcMtSetPriority

Examples

This example unsets the priority of the NUMERIC_DATA message type:

T_IPC_MT mt; 
 
mt = TipcMtLookup("numeric_data"); 
if (mt == NULL) { 
  return;  /* error */ 
} 
 
if (!TipcMtSetPriorityUnknown(mt)) { 
  return;  /* error */ 
}