BACnetUnconfTextMessage (FUN)

FUNCTION BACnetUnconfTextMessage : IEC_BACNET_STATUS

Sends an unconfirmed TextMessage.

Sends an Unconfirmed-Text-Message service request to remote device. This service may be broadcast, multicast, or addressed to a single recipient. This service may be used in cases where confirmation that the text message was received is not required. Message may be prioritized into Normal or Urgent categories. A text message may be optionally classified by a numeric class code or class identification string. The interpretation of the class is a local matter.

InOut:

Scope

Name

Type

Comment

Return

BACnetUnconfTextMessage

IEC_BACNET_STATUS

Input

pSourceAddress

POINTER TO IEC_BACNET_ADDRESS

If the BACnet application has only one device constructed and installed, this can be NULL. In this case the MAC address of this device will be used. Otherwise this shall be the MAC address returned on device object construction.

pDestinationAddress

POINTER TO IEC_BACNET_ADDRESS

This is the MAC address of the device to which the request should be sent.

pServiceInfo

POINTER TO IEC_BACNET_TEXT_MESSAGE_INFO

A pointer to the service information data structure. This data structure of datatype BACNET_TEXT_MESSAGE_INFO contains an object Identifier of device object of the request initiator, a boolen if Message Class Present attribute, a message class, a message priority, a message string type and a message string.