LabWindows/CVI

DS_IsConnected

HRESULT DS_IsConnected (DSHandle DSHandle, int *isConnected);

Purpose

Returns a Boolean value indicating whether a DataSocket object is connected to its data source.

Parameters

Input
Name Type Description
DSHandle DSHandle Pass the handle you obtained from DS_Open, DS_GetAttrHandle, or DS_CreateAttrHandle to identify the DataSocket object.
Output
Name Type Description
isConnected int Returns a boolean value indicating whether the DataSocket object is connected to its data source.

Valid Range
0—not connected
1—connected

Return Value

Name Type Description
status HRESULT The value that indicates whether an error occurred. A negative error code indicates function failure.

Error codes are defined in CVIversion\toolslib\datasock\dataskt.h and <Program Files>\National Instruments\Shared\MSDTRedistributables\SDKHeaderFiles\8.1\winerror.h. Other error codes in winerror.h are generated by ActiveX Servers and are passed on to you by the DataSocket Library.

Additional Information

Library: DataSocket Library

Include file: datasock\dataskt.h

LabWindows/CVI compatibility: LabWindows/CVI 6.0 and later

Log in to get a better experience