McomInquire

See also

Reference:

McomAlloc McomControl McomRead McomWaitPositionRequest

Availability

Not available in MIL-Lite

Available in MIL

Available on Windows

Available on Linux

Not supported on:

Not supported on Matrox GigE Vision driver (MIL 10, Update 25, Update 54, or Update 85)* (c)

Not supported on Matrox Morphis (g)

Not supported on Matrox Morphis QxT (h)

Not supported on Matrox Orion HD (i)

Not supported on Matrox Radient eCL (j)

Not supported on Matrox Radient eV-CXP (MIL 10 or Update 29)* (k)

Not supported on Matrox Solios eA/XA (l)

Not supported on Matrox Solios ecl/xcl/ev-cl (m)

Not supported on Matrox USB3 Vision driver (Update 19) (o)

Not supported on Matrox RadientPro-CL (Update 7) (p)

Not supported on Matrox Radient eV-CL (Update 27 or 74) (r)

Not supported on Matrox Clarity UHD (Update 36 or 76) (u)

Not supported on Matrox GenTL driver (Update 34) (v)

Not supported on Matrox Rapixo CXP (Update 75 or Update 84) (y)

Not supported on Matrox Concord PoE with ToE (Update 82) (z)

Not supported on Matrox Rapixo CL Pro (Update 96) (aa)

Partially supported on:

Partially supported on Host system (a)

Fully supported on:

Fully supported on Matrox Iris GTR (Update 28 or Update 68) (t)

Fully supported on Matrox Indio (Update 53 or Update 68) (w)

* Refer to the MIL system-specific information
in the MIL Reference for the minimum update required.

For any information regarding a MIL system added during a MIL Update, see the MIL system’s release note

Not available on Non-Matrox computer

Not available on Matrox 4Sight-X

Not available on Matrox Supersight

Available on Matrox 4Sight GP/GPm

Function map

Examples

cclinkslave.cpp
cclinkslave.cs

Function Map

- ComId

Parameter Associations

Table:	For inquiring about the system
Table:	For any type of Industrial Communication context
Table:	For an Industrial Communication context for use with a robot controller
+ combination:	For getting the string size
Table:	For an Industrial Communication context for use with a PROFINET device
+ combination:	For a PROFINET PLC in a redundant mode
+ combination:	To specify the module's index in a Matrox PROFINET automation device
Table:	For an Industrial Communication context for use with a EtherNet/IP device
Table:	For an Industrial Communication context for use with a CC-Link IE Field Basic device

Return value

Compilation information

Synopsis

Inquire about an Industrial Communication context setting.

Syntax

MIL_INT McomInquire(

MIL_ID ComId,	//in
MIL_INT64 InquireType,	//in
void *UserVarPtr	//out

)

Description

This function inquires about a setting of the Industrial Communication context.

This function is only available if you have the MIL Industrial Communication package, or another relevant update installed.

Note that this function reference has not been updated for a MIL system added during a MIL update. Refer to the MIL system's release note to see which MIL system’s documentation you should use in its place and any possible differences.

Parameters

This function is not supported on the selected boards.

This function reference has not been updated for the selected MIL system. To show the content of this page, choose a second MIL system; refer to the MIL system's release note to see which MIL system’s documentation to choose and any possible differences.

Parameters

ComId

Specifies the identifier of the Industrial Communication context.

InquireType

Specifies the setting about which to inquire.

See the Parameter associations section for possible values that can be specified.

UserVarPtr

Accepts the address of one of the following (see the Parameter associations section for specifics on which is expected):

array of type MIL_TEXT_CHAR [optionally, in C++: a reference to a MIL_STRING]
MIL_BOOL
MIL_ID
MIL_INT
MIL_INT64
MIL_UINT64

Specifies the address of the variable in which to return the value of the inquired setting. Since the McomInquire() function also returns the requested information, you can set this parameter to M_NULL.

See the Parameter associations section for possible values that can be returned.

Parameter associations

The tables below list possible values for the InquireType parameter and possible values returned to the UserVarPtr parameter.

For inquiring about the system
For any type of Industrial Communication context
For an Industrial Communication context for use with a robot controller
For an Industrial Communication context for use with a PROFINET device
For an Industrial Communication context for use with a EtherNet/IP device
For an Industrial Communication context for use with a CC-Link IE Field Basic device

The following InquireType parameter settings can be specified for any Industrial Communication context type, to inquire the system on which the context was allocated.

For inquiring about the system
InquireType		Description	MIL system-specific tooltip (‡)
	UserVarPtr - Possible values returned	Description
M_OWNER_SYSTEM		Inquires the identifier of the system on which the Industrial Communication context was allocated. SET (summarize) Inquires the identifier of the system on which the Industrial Communication context was allocated. SET (more details...)					‡	a	t U28	w U53
	UserVarPtr extra info	Data type info: Data type: address of a MIL_ID Data type: address of a MIL_ID Data type info: Data type: address of a MIL_ID Data type: address of a MIL_ID	‡	a	t U28	w U53
	M_DEFAULT_HOST	Specifies the default Host system of the current MIL application.	‡	a	t U28	w U53
	MIL system identifier	Specifies a valid system identifier, previously allocated using MsysAlloc().	‡	a	t U28	w U53

The following InquireType parameter settings can be specified for any Industrial Communication context type.

For any type of Industrial Communication context
InquireType		Description	MIL system-specific tooltip (‡)
	UserVarPtr - Possible values returned	Description
M_COM_DEVICE_DESCRIPTION +		Inquires the description of the device. SET (summarize) Inquires the description of the device. SET (more details...)					‡	a	t U28	w U53
	UserVarPtr extra info	Data type info: Data type: array of type MIL_TEXT_CHAR [optionally, in C++: MIL_STRING ] MORE Data type: array of type MIL_TEXT_CHAR [optionally, in C++: MIL_STRING ] Required array size: McomInquire ( M_COM_DEVICE_DESCRIPTION + M_STRING_SIZE ) Note: When using C++, you can pass a reference to a MIL_STRING instead. In this case, the function will automatically determine the correct string size. Data type info: Data type: array of type MIL_TEXT_CHAR [optionally, in C++: MIL_STRING ] MORE Data type: array of type MIL_TEXT_CHAR [optionally, in C++: MIL_STRING ] Required array size: McomInquire ( M_COM_DEVICE_DESCRIPTION + M_STRING_SIZE ) Note: When using C++, you can pass a reference to a MIL_STRING instead. In this case, the function will automatically determine the correct string size.	‡	a	t U28	w U53
	MIL_TEXT("IPOrName:Port") ¹	Specifies the IP address and port on the robot controller to use to communicate with it. INFO	‡	a	t U28	w U53
	MIL_TEXT("M_DEFAULT") ¹	Specifies to communicate with the default device described in MILConfig that uses the specified protocol. INFO	‡	a	t U28	w U53
M_COM_GET_CONNECTION_STATE		Inquires whether the device is connected. (summarize) Inquires whether the device is connected. (more details...)	‡	a	t U28	w U53
	UserVarPtr extra info	Data type info: Data type: address of a MIL_BOOL Data type: address of a MIL_BOOL Data type info: Data type: address of a MIL_BOOL Data type: address of a MIL_BOOL	‡	a	t U28	w U53
	M_FALSE	Specifies that the device is not connected.	‡	a	t U28	w U53
	M_TRUE	Specifies that the device is connected.	‡	a	t U28	w U53
M_COM_INIT_VALUE		Inquires how the Industrial Communication context was initialized. SET (summarize) Inquires how the Industrial Communication context was initialized. SET (more details...)	‡	a	t U28	w U53
	UserVarPtr extra info	Data type info: Data type: address of a MIL_UINT64 Data type: address of a MIL_UINT64 Data type info: Data type: address of a MIL_UINT64 Data type: address of a MIL_UINT64	‡	a	t U28	w U53
	M_DEFAULT	Specifies the default behavior. INFO	‡	a	t U28	w U53
	M_COM_NO_CONNECT	Specifies not to automatically connect to the robot controller.	‡	a	t U28	w U53
M_COM_IS_HARDWARE		Inquires if the MIL system is using a hardware-assisted acceleration device to communicate with the target device. (summarize) Inquires if the MIL system is using a hardware-assisted acceleration device to communicate with the target device. (more details...)	‡	a	t U28	w U53
	UserVarPtr extra info	Data type info: Data type: address of a MIL_BOOL Data type: address of a MIL_BOOL Data type info: Data type: address of a MIL_BOOL Data type: address of a MIL_BOOL	‡	a	t U28	w U53
	M_FALSE	Specifies that the system is not using a hardware-assisted acceleration device.	‡	a	t U28	w U53
	M_TRUE	Specifies that the system is using a hardware-assisted acceleration device.	‡	a	t U28	w U53
M_COM_PROTOCOL_TYPE		Inquires the type of protocol for which the context was allocated. SET (summarize) Inquires the type of protocol for which the context was allocated. SET (more details...)	‡	a	t U28	w U53
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT64 Data type: address of a MIL_INT64 Data type info: Data type: address of a MIL_INT64 Data type: address of a MIL_INT64	‡	a	t U28	w U53
	M_COM_PROTOCOL_ABB	Specifies an ABB robot controller protocol.	‡	a	t U28	w U53
	M_COM_PROTOCOL_CCLINK	Specifies a CC-Link IE Field Basic protocol.	‡	a	t U28	w U53
	M_COM_PROTOCOL_DENSO	Specifies a DENSO robot controller protocol.	‡	a	t U28	w U53
	M_COM_PROTOCOL_EPSON	Specifies an Epson robot controller protocol.	‡	a	t U28	w U53
	M_COM_PROTOCOL_ETHERNETIP	Specifies an Ethernet/IP protocol.	‡	a	t U28	w U53
	M_COM_PROTOCOL_FANUC	Specifies a Fanuc robot controller protocol.	‡	a	t U28	w U53
	M_COM_PROTOCOL_KUKA	Specifies a KUKA robot controller protocol.	‡	a	t U28	w U53
	M_COM_PROTOCOL_MODBUS	Specifies a Modbus protocol.	‡	a	t U28	w U53
	M_COM_PROTOCOL_PROFINET	Specifies a PROFINET protocol. INFO	‡	a	t U28	w U53
	M_COM_PROTOCOL_STAUBLI	Specifies a Staubli robot controller protocol.	‡	a	t U28	w U53
M_COM_TIMEOUT		Inquires the maximum amount of time to wait for a receiving function (for example, McomRead() or McomWaitPositionRequest()) to finish its execution. SET (summarize) Inquires the maximum amount of time to wait for a receiving function (for example, McomRead() or McomWaitPositionRequest()) to finish its execution. SET (more details...)	‡	a	t U28	w U53
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT	‡	a	t U28	w U53
	Value	Specifies the maximum amount of time to wait, in msecs.	‡	a	t U28	w U53

¹ If the value was passed in a variable, it won't be returned enclosed in MIL_TEXT().

The following InquireType parameter settings can be specified for an Industrial Communication context allocated to communicate with a robot controller.

For an Industrial Communication context for use with a robot controller
InquireType		Description	MIL system-specific tooltip (‡)
	UserVarPtr - Possible values returned	Description
M_COM_REMOTE_ADDRESS +		Inquires the IP address of the robot controller. SET SET (summarize) Inquires the IP address of the robot controller. SET SET (more details...)					‡	a	t U28	w U53
	UserVarPtr extra info	Data type info: Data type: array of type MIL_TEXT_CHAR [optionally, in C++: MIL_STRING ] MORE Data type: array of type MIL_TEXT_CHAR [optionally, in C++: MIL_STRING ] Required array size: McomInquire ( M_COM_REMOTE_ADDRESS + M_STRING_SIZE ) Note: When using C++, you can pass a reference to a MIL_STRING instead. In this case, the function will automatically determine the correct string size. Data type info: Data type: array of type MIL_TEXT_CHAR [optionally, in C++: MIL_STRING ] MORE Data type: array of type MIL_TEXT_CHAR [optionally, in C++: MIL_STRING ] Required array size: McomInquire ( M_COM_REMOTE_ADDRESS + M_STRING_SIZE ) Note: When using C++, you can pass a reference to a MIL_STRING instead. In this case, the function will automatically determine the correct string size.	‡	a	t U28	w U53
	MIL_TEXT("n.n.n.n") ¹	Specifies the IP address of the robot controller.	‡	a	t U28	w U53
M_COM_REMOTE_PORT		Inquires the port on the robot controller to use to communicate with it. SET SET (summarize) Inquires the port on the robot controller to use to communicate with it. SET SET (more details...)	‡	a	t U28	w U53
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT	‡	a	t U28	w U53
	Value > 0	Specifies the port on the robot controller.	‡	a	t U28	w U53
M_COM_ROBOT_CONNECT_RETRY		Inquires the maximum number of times to attempt to reconnect to the robot controller. SET (summarize) Inquires the maximum number of times to attempt to reconnect to the robot controller. SET (more details...)	‡	a	t U28	w U53
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT	‡	a	t U28	w U53
	Value	Specifies the maximum number of times to attempt to reconnect.	‡	a	t U28	w U53
M_COM_ROBOT_CONNECT_RETRY_WAIT		Inquires the amount of time to wait between attempts to connect to the robot-controller. SET (summarize) Inquires the amount of time to wait between attempts to connect to the robot-controller. SET (more details...)	‡	a	t U28	w U53
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT	‡	a	t U28	w U53
	Value	Specifies the amount of time to wait, in msecs.	‡	a	t U28	w U53
M_COM_ROBOT_ISCONNECTED		Inquires whether the robot controller is connected. (summarize) Inquires whether the robot controller is connected. (more details...)	‡	a	t U28	w U53
	UserVarPtr extra info	Data type info: Data type: address of a MIL_BOOL Data type: address of a MIL_BOOL Data type info: Data type: address of a MIL_BOOL Data type: address of a MIL_BOOL	‡	a	t U28	w U53
	M_FALSE	Specifies the robot controller is not connected.	‡	a	t U28	w U53
	M_TRUE	Specifies the robot controller is connected.	‡	a	t U28	w U53

¹ If the value was passed in a variable, it won't be returned enclosed in MIL_TEXT().

Combination value for M_COM_DEVICE_DESCRIPTION; M_COM_REMOTE_ADDRESS.

You can add the following value to the above-mentioned values to get the string's length.

For getting the string size
InquireType		Description	MIL system-specific tooltip (‡)
	UserVarPtr - Possible values returned	Description
M_STRING_SIZE		Retrieves the length of the string, including the terminating null character ("\0"). (summarize) Retrieves the length of the string, including the terminating null character ("\0"). (more details...)					‡	a	t U28	w U53
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT	‡	a	t U28	w U53

The following InquireType parameter settings can be specified for an Industrial Communication context allocated to communicate using the PROFINET protocol (McomAlloc() with M_COM_PROTOCOL_PROFINET).

For an Industrial Communication context for use with a PROFINET device
InquireType		Description		MIL system-specific tooltip (‡)
	UserVarPtr - Possible values returned	Description
M_COM_PROFINET_GET_MODULE_INSIZE +		Inquires the amount of memory that the PROFINET controller expects to be allocated to the module in local memory, which can be used to send input data to the controller (for example, a PLC). The expected module's size can be modified using the Siemens Totally Integrated Automation (TIA) portal of the controller. Note that if the PROFINET controller is not currently connected, the module's last known size is returned. You must specify a combination value from the following table: To specify the module\'s index in the local computer (summarize) Inquires the amount of memory that the PROFINET controller expects to be allocated to the module in local memory, which can be used to send input data to the controller (for example, a PLC). (more details...)						‡	a	t U28	w U53
			MIL system specific
			Note that the Host system is only supported on the Matrox 4Sight GPm and EV6 platforms. Support for the Matrox 4Sight EV6 platform requires driver update 93.	‡	a
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT		‡	a	t U28	w U53
	Value	Specifies the expected input module's size, in bytes.		‡	a	t U28	w U53
M_COM_PROFINET_GET_MODULE_OUTSIZE +		Inquires the amount of memory that the PROFINET controller expects to be allocated to the module in local memory, to which the controller can write. The expected module's size can be modified using the Siemens Totally Integrated Automation (TIA) portal of the controller. Note that if the PROFINET controller is not currently connected, the module's last known size is returned. You must specify a combination value from the following table: To specify the module\'s index in the local computer (summarize) Inquires the amount of memory that the PROFINET controller expects to be allocated to the module in local memory, to which the controller can write. (more details...)		‡	a	t U28	w U53
			MIL system specific
			Note that the Host system is only supported on the Matrox 4Sight GPm and EV6 platforms. Support for the Matrox 4Sight EV6 platform requires driver update 93.	‡	a
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT		‡	a	t U28	w U53
	Value	Specifies the expected output module's size, in bytes.		‡	a	t U28	w U53
M_COM_PROFINET_GET_PLC_STATE		Inquires the state of the PROFINET controller (PLC) connected to the local computer. The inquired controller state is the state as of the last alarm transfer cycle. (summarize) Inquires the state of the PROFINET controller (PLC) connected to the local computer. (more details...)		‡	a	t U28	w U53
			MIL system specific
			Note that the Host system is only supported on the Matrox 4Sight GPm and EV6 platforms. Support for the Matrox 4Sight EV6 platform requires driver update 93.	‡	a
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT		‡	a	t U28	w U53
	M_COM_PROFINET_STATUS_RUN +	Specifies that the PROFINET PLC is running.		‡	a	t U28	w U53
	M_COM_PROFINET_STATUS_STOP +	Specifies that the PROFINET PLC has stopped.		‡	a	t U28	w U53

Combination values for M_COM_PROFINET_STATUS_RUN (when InquireType=M_COM_PROFINET_GET_PLC_STATE and UserVarPtr=M_COM_PROFINET_STATUS_RUN); M_COM_PROFINET_STATUS_STOP (when InquireType=M_COM_PROFINET_GET_PLC_STATE and UserVarPtr=M_COM_PROFINET_STATUS_STOP).

One of the following values might be combined with the above-mentioned values to specify in which redundant mode the PLC is running.

For a PROFINET PLC in a redundant mode
Combination value	Description		MIL system-specific tooltip (‡)
M_COM_PROFINET_STATUS_BACKUP	Specifies that the PROFINET PLC, running in a redundant mode, is using the backup network channel. (summarize) Specifies that the PROFINET PLC, running in a redundant mode, is using the backup network channel. (more details...)		‡	a	t U28	w U53
		MIL system specific
		Note that the Host system is only supported on the Matrox 4Sight GPm and EV6 platforms. Support for the Matrox 4Sight EV6 platform requires driver update 93.	‡	a
M_COM_PROFINET_STATUS_PRIMARY	Specifies that the PROFINET PLC, running in a redundant mode, is using the primary network channel. (summarize) Specifies that the PROFINET PLC, running in a redundant mode, is using the primary network channel. (more details...)		‡	a	t U28	w U53
		MIL system specific
		Note that the Host system is only supported on the Matrox 4Sight GPm and EV6 platforms. Support for the Matrox 4Sight EV6 platform requires driver update 93.	‡	a

Combination value for M_COM_PROFINET_GET_MODULE_INSIZE; M_COM_PROFINET_GET_MODULE_OUTSIZE.

You must add the following value to the above-mentioned values to specify the module's index in the local computer.

To specify the module's index in a Matrox PROFINET automation device
Combination value	Description		MIL system-specific tooltip (‡)
0 <= Index <= 15	Specifies the module's index in the local computer. (summarize) Specifies the module's index in the local computer. (more details...)		‡	a	t U28	w U53
		MIL system specific
		Note that the Host system is only supported on the Matrox 4Sight GPm and EV6 platforms. Support for the Matrox 4Sight EV6 platform requires driver update 93.	‡	a

The following InquireType parameter settings can be specified for an Industrial Communication context allocated to communicate using the EtherNet/IP protocol (McomAlloc() with M_COM_PROTOCOL_ETHERNETIP).

For an Industrial Communication context for use with a EtherNet/IP device
InquireType		Description	MIL system-specific tooltip (‡)
	UserVarPtr - Possible values returned	Description
M_COM_ETHERNETIP_CONFIG_SIZE		Inquires the amount of memory that is allocated to the configuration assembly in local memory, from which the controller can read EtherNet/IP configuration data that you have written about the local computer. Note that the size of this assembly can be changed using the MILConfig utility. The controller must be configured to recognize this size. (summarize) Inquires the amount of memory that is allocated to the configuration assembly in local memory, from which the controller can read EtherNet/IP configuration data that you have written about the local computer. (more details...)					‡	a	t U28	w U53
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT	‡	a	t U28	w U53
	Value	Specifies the size of the configuration assembly, in bytes.	‡	a	t U28	w U53
M_COM_ETHERNETIP_CONSUMER_SIZE		Inquires the amount of memory that is allocated to the consumer assembly in local memory, to which the controller can write. Note that the size of this assembly can be changed using the MILConfig utility. The controller must be configured to recognize this size. (summarize) Inquires the amount of memory that is allocated to the consumer assembly in local memory, to which the controller can write. (more details...)	‡	a	t U28	w U53
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT	‡	a	t U28	w U53
	Value	Specifies the size of the consumer assembly, in bytes.	‡	a	t U28	w U53
M_COM_ETHERNETIP_PRODUCER_SIZE		Inquires the amount of memory that is allocated to the producer assembly in local memory, from which the controller can read. Note that the size of this assembly can be changed using the MILConfig utility. The controller must be configured to recognize this size. (summarize) Inquires the amount of memory that is allocated to the producer assembly in local memory, from which the controller can read. (more details...)	‡	a	t U28	w U53
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT	‡	a	t U28	w U53
	Value	Specifies the size of the producer assembly, in bytes.	‡	a	t U28	w U53

The following InquireType parameter settings can be specified for an Industrial Communication context allocated to communicate using the CC-Link IE Field Basic protocol (McomAlloc() with M_COM_PROTOCOL_CCLINK).

For an Industrial Communication context for use with a CC-Link IE Field Basic device
InquireType		Description	MIL system-specific tooltip (‡)
	UserVarPtr - Possible values returned	Description
M_COM_CCLINK_TOTAL_OCCUPIED_STATION		Inquires the number of stations occupied by the CC-Link IE Field Basic protocol instance. This determines the size of the register and flag data tables available for the controller to read from and write to. For each station, there are 32 input registers, 32 output registers, 64 input flags, and 64 output flags. Note that the number of stations occupied by the protocol instance can be changed using the MILConfig utility. The controller must be configured to make this number of stations available. (summarize) Inquires the number of stations occupied by the CC-Link IE Field Basic protocol instance. (more details...)					‡	a	t U28	w U53
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT	‡	a	t U28	w U53
	Value	Specifies the number of stations.	‡	a	t U28	w U53

Return value

The returned value is the requested information, cast to a MIL_INT. If the requested information does not fit into a MIL_INT, this function will return M_NULL or truncate the information.

Compilation information

Header	Include mil.h.
Library	Use mil.lib; milcom.lib.
DLL	Requires mil.dll; milcom.dll.