eDNA .NET接口功能说明及示例

eDNA在各个功能层面都提供了丰富的程序接口，为了便于用户使用.NET进行应用或者接口开发，本文将eDNA常用的API进行了封装，以便于用户在.NET平台下使用eDNA开发接口，封装时使用的语言是C#。
本文从功能的角度，按照如下图所示的命名空间结构对eDNA的开发接口进行了划分。下图中，浅蓝色图形代表一个.NET类（Class），白色图形则代表.NET的命名空间（Namespace）。本文出了给出eDNA各开发接口的.NET封装、其功能说明、参数说明、返回值说明之外，同时还给出了示例程序以及示例程序在不同情况下的输出和运行效果，以便于用户正确有效地使用eDNA接口函数所提供的功能,测试中使用的库文件为ezdnaapi.dll（2.3.21.23），EZDnaServApi.dll（1.4.0.4）。
印

目录：
1. 概述....................1
2. 配置参数函数.......4
2.1读取服务信息.4
2.1.1 DnaSelectService.......4
2.1.2 DnaGetServiceList.....6
2.2读取点信息...14
2.2.1 DnaSelectPoint.........14
2.2.2 DnaSelectHistoryPoint.......15
2.2.3 DnaGetRTIds.17
2.2.4 DnaGetPointList.......19
2.2.5 DnaGetRTRefs.........29
2.2.6 ShortIdFromLongId.34
2.2.7 LongIdFromShortId.35
2.2.8 ExtendedIdFromShortId.....37
2.2.9 ShortIdFromExtendedId.....39
2.2.10 DoesIdExist..41
2.2.11 DoesExtendedIdExist.......43
3. 实时服务函数.....47
3.1读取秒时标实时数据........47
3.1.1 DNAGetRTTime.....47
3.1.2 DNAGetRTStatus....50
3.1.3 DNAGetRTShort.....53
3.1.4 DNAGetRTValue....56
3.2读取毫秒时标实时数据.....60
3.2.1 DNAGetHsShort......60
4. 历史服务函数.....63
4.1读取秒时标历史数据.......63
4.1.1 DnaGetHistAvg........63
4.1.2 DnaGetHistSnap.......69
4.1.3 DnaGetHistMax.......75
4.1.4 DNAGetHistMin......81
4.1.5 DnaGetNextHist.......87
4.1.6 DNAGetHistRaw.....90
4.1.7 DNAGetHistAllStats95
4.1.8 DNAGetThisHistAllAvg....99
4.1.9 DNAGetThisHistAllMax.104
4.1.10 DNAGetThisHistAllMin109
4.1.11 DnaNextHistAll....114
4.1.12 DnaGetHistExpectedTotal........118
4.2插入秒时标历史数据.......121
4.2.1 DnaHistUpdateInsertValues.......121
4.2.2 DnaHistQueueUpdateInsertValue........125
4.2.3 DnaHistFlushUpdateInsertValues........129
4.3补充秒时标历史数据.......131
4.3.1 DnaHistAppendValues.....131
4.3.2 DnaHistQueueAppendValue......135
4.3.3 DnaHistFlushAppendValues......139
4.4删除秒时标历史数据.......141
4.4.1 DnaHistDeleteValue.........141
4.4.2 DnaHistDeleteBlock........144
4.5更改历史数据保留精度...153
4.5.1 DnaHistDefinePoint.........153
4.6读取毫秒时标历史数据..159
4.6.1 DnaGetHSHistAvg.159
4.6.2 DnaGetHSHistSnap.........161
4.6.3 DnaGetHSHistMax164
4.6.4 DnaGetHSHistMin.167
4.6.5 DnaGetNextHSHist170
4.6.6 DnaGetHSHistRaw172
4.7插入毫秒时标历史数据...176
4.7.1 DnaHSHistUpdateInsertValues..176
4.7.2 DnaHSHistQueueUpdateInsertValue....180
4.7.3 DnaHSHistFlushUpdateInsertValues....184
4.8 补充毫秒时标历史数据..186
4.8.1 DnaHSHistAppendValues186
4.8.2 DnaHSHistQueueAppendValue..190
4.8.3 DnaHSHistFlushAppendValues.194
5. Universal函数..197
5.1服务初始化、连接、关闭.........197
5.1.1 eDnaMxUniversalInitialize.....197
5.1.2 eDnaMxUniversalDataConnect.209
5.1.3 eDnaMxUniversalCloseSocket..211
5.1.4 ISeDnaMxUniversalConnected.212
5.1.5 eDnaMxFlushUniversalRecord.212
5.2修改点配置信息...215
5.2.1 eDnaMxAddConfigRec...215
5.2.2 eDnaMxDeleteConfigurationRec.........226
5.2.3 eDnaMxDeleteLongIdConfigurationRec........232
5.3写入数据.....239
5.3.1单点写入..239
5.3.1.1 eDnaMxAddRec.239
5.3.1.2 eDnaMxAddLongIdRec248
5.3.2按点批量写入....255
5.3.2.1 eDnaMxSetPointId+eDnaMxAddUniversalRecord.........255
5.3.2.2 eDnaMxSetLongId+eDnaMxAddUniversalRecord.........261
6. Utility函数.......268
6.1 DataTimeToUTC...268
6.2 UTCToDataTime...269