Add return code for Kafka::produce and free message payload memory in rd_kafka_example when queue is full

Hi, Edenhill.

Many thanks for you reply.

I've made a clear patch and pull it for your review.

Changes:
(1) Add return code for Kafka::produce
(2) Free message payload memory in rd_kafka_example