navMessageStatusRequest (Function)

Top  Previous  Next

Architecture:

X32 / NX32 / NX32L

Device support:

MX2, AX9, CX1 pro/flex/warp, SX1, MX2 turbo/encore/warp, AX9 turbo, NX-200, NX-400, NX-900, LX2, LX4, LX5

Firmware version:

1.40 / 1.00.00

Nav. API level:

1


This function will request the status for a text message.

A "message status" event is raised when the text message status is received. See also navWaitEvent for event # 3.

 

 

Input:

id : INT

The ID used to identify the text message in navMessageSend.

 

 

Returns: INT

0

- Success.

-1

- Navigation interface is not open.

-2

- Error communicating with navigation device.

-12

- Navigation interface is busy.

 

Declaration:

FUNCTION navMessageStatusRequest : INT;
VAR_INPUT
  ID : INT;
END_VAR;

 

Example:

INCLUDE rtcu.inc
 
PROGRAM NavigationExample;
 
BEGIN
  ...
  // Request the status of a text message
  navMessageStatusRequest(id := 55);
  ...
END;
END_PROGRAM;