Admin Production ni-theme
Current Publication

CNVGetScalarDataValue

LabWindows/CVI

CNVGetScalarDataValue

int CNVGetScalarDataValue (CNVData data, CNVDataType type, void *value);

Purpose

Gets the value of scalar data.

Parameters

Input
Name Type Description
data CNVData The handle that identifies the network variable data.
type CNVDataType The type of the specified network variable data. Note that CNVBool refers to a 1-byte boolean type (char or unsigned char), and CNVString refers to a C-style NUL-terminated string.
Output
Name Type Description
value void * The value of the network variable data. The Network Variable Library allocates returned strings. You must free these strings using CNVFreeMemory.

Return Value

Name Type Description
status int Return value indicating whether the function was successful. One indicates that a next item was found, zero indicates that a next item was not found, and a negative number indicates that an error occurred.

You can call CNVGetErrorDescription to obtain a string that describes the error.

Additional Information

Library: Network Variable Library

Include file: cvinetv.h

LabWindows/CVI compatibility: LabWindows/CVI 8.1 and later

Examples

Refer to the following examples that use the CNVGetScalarDataValue function:

  • apps\chess\chess.cws

    Open example
  • networkvariable\3DSim\NV3DSim.cws

    Open example
  • networkvariable\Polling\NVPolling.cws

    Open example