PviUnlink, PviXUnlink functions

<< 点击显示目录 >>

主页  PVI通信 > PVI帮助信息 > PVI base system > PVICOM interface > PVICOM functions >

PviUnlink, PviXUnlink functions

Definition for C/C++

int PviUnlink (DWORD LinkID)

int PviXUnlink (DWORD hPvi, DWORD LinkID)

Definition for Basic

PviUnlink (ByVal LinkID As Long) As Long

PviXUnlink (ByVal hPvi As Long, ByVal LinkID As Long) As Long

Arguments

Argument

I/O

说明

hPvi

In

来自 PviXInitialize 函数的实例句柄

LinkID

In

来自 PviCreateResponsePviLinkResponse 或PviXCreateResponse、PviXLinkResponse函数链接ID

Return value

如果数值不是0,则表明有错误。错误代码将作为一个值返回。如果在执行请求时发生错误,或者 通信实例 和PVI管理器之间的连接  中断(通信超时)则报告错误

Description

该函数是 PviUnlinkRequest / PviUnlinkResponse 或PviXUnlinkRequest / PviXUnlinkResponse功能 的同步变量 参见 异步和同步功能 部分。

在执行PviUnlink或PviXUnlink功能后,对象的所有响应和事件数据将被删除。 然而 当把窗口信息作为 用户信息,那些已经发送的用户信息不能再被删除(信息队列)。如果PVICOM应用程序通过调用PVI响应函数(Pvi...Response或PviX...Response)或 PviGetResponseInfo 或PviXGetResponseInfo函数来响应这些用户消息之一,则返回错误12055 因此,PVICOM应用程序必须查询错误1205并进行相应的处理。一个更好的选择是使用异步函数PviUnlinkRequest / PviUnlinkResponse或PviXUnlinkRequest / PviXUnlinkResponse。这可以防止这种情况的发生,因为一旦收到解除链接响应数据的用户信息,对象就不存在额外的用户信息了.