OPC常用函数.doc

函数名称: CreateServer功能 : 创建OPC服务器参数说明: pClass 类标识 必须是一个合法的GUID ServerRate 服务器标签刷新速率Public Declare Function CreateServer Lib ASOPCDA.DLL (ByVal pClass As String, ByVal ServerRate As Long) As Long函数名称: FreeServer功能 : 释放OPC服务器Public Declare Function FreeServer Lib ASOPCDA.DLL () As Long函数名称: ActiveCode功能 : 用户名/序列号激活服务器Public Declare Function ActiveCode Lib ASOPCDA.DLL (ByVal lpName As String, ByVal lpCode As String) As Long函数名称: ShutDown功能 : 强行断开所有客户端连接Public Declare Sub Shutdown Lib ASOPCDA.DLL Alias ShutDown ()函数名称: SetServerState功能 : 设置服务器运行状态参数说明: State 服务器运行状态 见OPC_STATUS常量声明Public Declare Function SetServerState Lib ASOPCDA.DLL (ByVal State As Integer) As Long函数名称: SetServerInfo功能 : 设置服务器版本信息参数说明: VendorInfo 厂商名称 wMajor 主版本号 wMinor 副版本号 wBuild 编译版本号Public Declare Function SetServerInfo Lib ASOPCDA.DLL (ByVal VendorInfo As String, ByVal wMajor As Integer, ByVal wMinor As Integer, ByVal wBuild As Integer) As Long函数名称: RegServer功能 : 注册服务器参数说明: pClass 类标识 必须是一个合法的GUID Name 应用程序标识 Descr 服务器注册说明 ExePath 服务器可执行文件的路径Public Declare Function RegServer Lib ASOPCDA.DLL (ByVal pClass As String, ByVal Name As String, ByVal Descr As String, ByVal ExePath As String) As Long函数名称: UnregServer功能 : 注销服务器参数说明: pClass 类标识 必须是一个合法的GUID Name 应用程序标识Public Declare Function UnregServer Lib ASOPCDA.DLL (ByVal pClass As String, ByVal Name As String) As Long函数名称: RegTagEx功能 : 向服务器地址空间增加标签参数说明: Handle 上级标签句柄（用于树型地址空间,如果平面型地址空间值为0） Name 标签名称 DataType 标签数据类型 IsWriteable 标签可写标志 true - 可以写入 false - 只读Public Declare Function RegTagEx Lib ASOPCDA.DLL (ByVal Handle As Long, ByVal Name As String, ByVal DataType As Integer, ByVal IsWriteable As Long) As Long函数名称: RegTag功能 : 向服务器地址空间增加标签参数说明: Handle 上级标签句柄（用于树型地址空间,如果平面型地址空间值为0） Name 标签名称 Value 初始化标签值 InitialQuality 初始化标签值质量 IsWriteable 标签可写标志 true - 可以写入 false - 只读Public Declare Function RegTag Lib ASOPCDA.DLL (ByVal Handle As Long, ByVal Name As String, ByVal Value As Variant, ByVal InitialQuality As Integer, ByVal IsWriteable As Long) As Long函数名称: UnregTag功能 : 从服务器地址空间删除标签参数说明: Handle 标签句柄Public Declare Function UnregTag Lib ASOPCDA.DLL (ByVal Handle As Long) As Long函数名称: AddTagProperty功能 : 增加标签属性参数说明: TagHandle 标签句柄 PropertyID 属性索引 Description 标签属性说明 Value 属性值返回值： 如果成功，返回标签的句柄,失败返回-1Public Declare Function AddTagProperty Lib ASOPCDA.DLL (ByVal Handle As Long, ByVal PropertyID As Long, ByVal Description As String, ByVal Value As Variant) As Long函数名称: AddTagProperty功能 : 增加标签属性参数说明: TagHandle 标签句柄 PropertyID 属性索引 Description 标签属性说明 DataType 属性数据类型返回值： 如果成功，返回标签的句柄,失败返回-1Public Declare Function AddTagPropertyEx Lib ASOPCDA.DLL (ByVal Handle As Long, ByVal PropertyID As Long, ByVal Description As String, ByVal DataType As Integer) As Long函数名称: SetTagProperty功能 : 设置标签属性参数说明: TagHandle 标签句柄 PropertyID 属性索引 Description 标签属性说明 Value 属性值返回值： 如果成功，返回标签的句柄,失败返回-1Public Declare Function SetTagProperty Lib ASOPCDA.DLL (ByVal Handle As Long, ByVal PropertyID As Long, ByVal Value As Variant) As Long函数名称: SetTagQualifier功能 : 设置树型地址空间标签的分隔符参数说明: Qualifier 标签分隔符Public Declare Function SetTagQualifier Lib ASOPCDA.DLL (ByVal Qualifier As String) As Long函数名称: UpdateTagWithTimeStamp功能 : 更新服务器地址空间标签数据参数说明: Handle 标签句柄 Value 标签值 Quality 标签值质量 timestamp 标签值时间Public Declare Function UpdateTagWithTimeStamp Lib ASOPCDA.DLL (ByVal Handle As Long, ByVal Value As Variant, ByVal Quality As Integer, ByVal timestamp As FILETIME) As Long函数名称: UpdateTag功能 : 更新服务器地址空间标签数据参数说明: Handle 标签句柄 Value 标签值 Quality 标签值质量标签时间按照服务器时间设置Public Declare Function UpdateTag Lib ASOPCDA.DLL (ByVal Handle As Long, ByVal Value As Variant, ByVal Quality As Integer) As Long函数名称: SetWriteCallBack功能 : 设置服务器写数据回调函数参数说明: lpCallback 写回调函数指针 格式 WriteTag(ByVal Handle As Long, ByVal pNewValue As Variant, ByRef pDeviceError As Integer)Public Declare Function SetWriteCallback Lib ASOPCDA.DLL (ByVal lpCallback As Long) As Long函数名称: SetReadCallBack功能 : 设置服务器读数据回调函数参数说明: lpCallback 读回调函数指针 格式 ReadTag(ByVal Handle As Long, ByRef pNewValue As Variant, ByRef pQuality as Integer, byRef Timestamp as FILETIME) Handle:标签句柄 pNewValue:值 pQuality :质量 Timestamp:时间戳 Public Declare Function SetReadCallback Lib ASOPCDA.DLL (ByVal lpCallback As Long) As Long函数名称: SetServerNotify功能 : 设置服务器实例建立、删除回调函数参数说明: lpCallback 写防范回调函数指针 格式 ServerNotify(hServer as Long, wOperateType as Integer) hServer - 服务器句柄 wOperateType:0-建立连接 1-断开连接Public Declare Function SetServerNotify Lib ASOPCDA.DLL (ByVal lpCallback As Long) As Long函数名称: SetGroupNotify功能 : 设置组操作回调函数参数说明: lpCallback 组操作回调函数指针 格式 GroupNotify(hServer as Long, hGroup As Long, Name as string, wOperateType as Integer) hServer:服务器句柄 hGroup:组句柄 Name:组名称 wOperateType:0-建立组 1-删除组Public Declare Function SetGroupNotify Lib ASOPCDA.DLL (ByVal lpCallback As Long) As Long函数名称: SetItemNotify功能 : 设置OPC标签映射增加、映射激活和映射删除回调函数参数说明: lpCallback 标签映射操作调函数指针 格式 ItemNotify(hServer as Long, hGroup As Long, hTag as Long, Active as Long, wOperateType as Integer) hServer:服务器句柄 hGroup:组句柄 hTag:标签句柄 Active:激活标志 wOperateType:0-映射标签 1-删除映射 2-激活/取消Public Declare Function SetItemNotify Lib ASOPCDA.DLL (ByVal lpCallback As Long) As Long函数名称: SetTagNotify功能 : 设置客户端增加服务器地址空间中不存在的标签时调用函数参数说明: lpCallback 写防范回调函数指针 格式 TagNotify(hTag as Long, name as string, path as string; ByRef pError as long ) hTag:服务器句柄 name:标签名称 path:访问路径 pError: 错误标志