tibrvMsg_GetCMSender()

Function

Declaration

tibrv_status tibrvMsg_GetCMSender(
    tibrvMsg         message,
    const char**     name);

Purpose

Extract the correspondent name of the sender from a certified message.

Parameter

Description

message

Extract the sender name from this message.

name

The program supplies a location. The function stores the name in that location.

Status

This function returns a status code that discriminates between labeled messages and other messages.

If the message is from a CM sender, then tibrvMsg_GetCMSender() returns the status code TIBRV_OK and yields a valid CM correspondent name.
If the message is not from a CM sender, then tibrvMsg_GetCMSender() returns the status code TIBRV_NOT_FOUND.

See Also

tibrvcmTransport_Create()

tibrvcmTransport_GetName()