extern struct frame* bpc_query

(struct CHANNEL_INSTANCE* inst,
  char message_type,
  long message_number,
  long answer_number,
  char more)

Returns the first (or all) frames available on a channel that matches the query parameters, if any.

Documentation

Returns the first (or all) frames available on a channel that matches the query parameters, if any.

Use bpc_message_destroy to deallocate the frame(s) returned.

Parameters:

inst - A pointer to the channel-instance structure.
message_type - Either BLU_QUERY_ANYTYPE, or one of:

• BLU_FRAME_TYPE_MSG
• BLU_FRAME_TYPE_RPY
• BLU_FRAME_TYPE_ANS
• BLU_FRAME_TYPE_NUL
• BLU_FRAME_TYPE_ERR

message_number - Either a specific message number, or BLU_QUERY_ANYMSG.
answer_number - Either a specific answer number, or BLU_QUERY_ANYANS.
more - Either BLU_QUERY_PARTIAL, to match any frame; or, BLU_QUERY_COMPLETE to match all frames contained in a complete message, but only if a complete message is available

Returns:

The old frame matching the query, or NULL.

Home Alphabetic index