CalMatrixGetDeviceFailedRelay

Purpose

Returns the specified relay’s number coil test status and description.

Syntax

CalMatrixGetDeviceFailedRelay (hHandle, psDescriptionAndStataus,psDescriptionAndStataus, plStatus)

Parameters

Name
Type
Comments
hHandle
LONG
Handle for a DMM.

psDescriptionAndStataus

LONG
The relay number to test its coil. Relay numbers are from 0 to 428.
psDescriptionAndStataus
PSTR
Returns the specified relay number’s status and description.
plStatus
PLONG
Returned status: 0 on success, negative number on failure.

Comments

The function returns the specified relay’s number coil test status and description.

This function supported only by the CalMatrixTS9xx.dll driver.

Example

The following example returns relay’s number 0 coil test status and description:

LONG    hHandle, lFailedDeviceRelays, lStatus;

CHAR    szDescriptionAndStatus [256];

CalMatrixGetDeviceFailedRelay (hHandle, 0, szDescriptionAndStatus, &lStatus);

printf(“Relay #0:%s”, szDescriptionAndStatus);

 

See Also

CalMatrixGetDeviceFailedRelays,  CalMatrixGetError