Declaration |
const char *mpiMessage(long messageId,
char *messageText)
|
|
|
Description |
mpiMessage returns the text
message associated with messageId and copies the text
to messageText if messageText is not
NULL.
|
|
If "messageText" is |
Then |
NULL |
Message returns a pointer to message
text resident in the library |
not NULL |
Message returns the pointer messageText,
which must point to a buffer large enough to hold the message text
(that will be copied into it) |
|
Return Values |
NULL |
if messageId is invalid |
Pointer to an empty
string (" ") |
if the messge utility is
not enabled or the message function pointer associated with messageId
is NULL. |
Pointer to a non-zero-length
string |
if the mpiMessage successsfully
retrieves the message associated with messageId. |
|
|