PviUnlinkAll, PviXUnlinkAll functions

<< 点击显示目录 >>

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

PviUnlinkAll, PviXUnlinkAll functions

Definition for C/C++

int PviUnlinkAll (LPVOID hEventMsg)

int PviXUnlinkAll (DWORD hPvi, LPVOID hEventMsg)

Definition for Basic

PviUnlinkAll (ByVal hEventMsgAs Long) As Long

PviXUnlinkAll (ByVal hPvi As Long, ByVal hEventMsgAs Long) As Long

Arguments

Argument

I/O

说明

hPvi

In

来自 PviXInitialize 函数的实例句柄

hEventMsg

In

窗口句柄或回调函数的指针。

Return value

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

Description

这个函数可以用一个函数调用来释放几个连接对象。在 "hEventMsg "中指定的窗口句柄或回调指针与 用户信息进行比较  ,以发出 通信实例 中所有链接对象的事件数据 。如果它们匹配,那么相应的链接对象被释放。通过这种方式,分配给某个窗口或回调函数的所有链接对象都可以被释放。

一旦链接对象被释放,就不会再  为这个对象发送事件 。此外,所有分配给链接对象的请求被取消,响应数据被删除。相应的用户信息不再被执行。

PviUnlinkAll和PviXUnlinkAll函数同步工作。没有异步的变体。参见 异步和同步函数 部分。