TipcPropertiesCreateMsg

Name

TipcPropertiesCreateMsg — create a properties table from a SmartSockets message

Synopsis

T_IPC_PROPERTIES TipcPropertiesCreateMsg(msg) 
T_IPC_MSG msg; 

Arguments

msg — a SmartSockets message

Return Values

Pointer to a properties table if successful, NULL otherwise.

Diagnostics

If TipcPropertiesCreateMsg fails, it returns NULL and sets the global SmartSockets error code to one of:

Description

TipcPropertiesCreateMsg creates a properties table from a SmartSockets message. msg must be a message with name-value pairs. The name-value pairs should be strings appended one after the other. Use the TipcMsgAppendStr function to append strings to a SmartSockets message.

Caution

None

See Also

TipcPropertiesDestroy, TipcPropertiesCreate, TipcPropertiesMsgCreate

Examples

This example creates a properties table from a SmartSockets message:

T_IPC_PROPERTIES props; 
T_IPC_MSG props_msg; 
 
/* create a properties table from a message */ 
props = TipcPropertiesCreateMsg(props_msg); 
if (props == NULL) { 
  return;  /* error */ 
}