PVI通信 > PVI帮助信息 > PVI base system > PVICOM interface > PVICOM functions > PviDeleteRequest, PviXDeleteRequest functions

Definition for C/C++

int PviDeleteRequest (LPCSTR pObjectName, LPVOID hResMsg, DWORD ResMsgNo, LPARAM ResParam)

int PviXDeleteRequest (DWORD hPvi, LPCSTR pObjectName, LPVOID hResMsg, DWORD ResMsgNo, LPARAM ResParam)

Definition for Basic

PviDeleteRequest (ByVal pObjectName As String, ByVal hResMsg As Long, ByVal ResMsgNo As Long, ByVal ResParam As Long) As Long

PviXDeleteRequest (ByVal hPvi As Long, ByVal pObjectName As String, ByVal hResMsg As Long, ByVal ResMsgNo As Long, ByVal ResParam As Long) As Long

Arguments

Argument	I/O	说明
hPvi	In	来自 PviXInitialize 函数的实例句柄
pObjectName	In	指向对象名称或对象路径名称的指针。以空尾的字符串形式给出。
hResMsg	In	用户信息的定义，它预示着这个函数调用的响应（请求和响应）。 = 0 (Null)。PVI管理器不发送任何响应
ResMsgNo	In	用户信息的编号 = 0 (Null):与hResMsg=0含义相同。
ResParam	In	用户信息的消息参数在32位PVI版本（PviCom.dll）中，消息参数（用户参数）的大小为4字节，在64位PVI版本（PviCom64.dll）中为8字节。

Return value

如果数值不是0，则表明有错误。错误代码被作为一个值返回。原则上，这个函数只报告Windows资源错误（如没有足够的可用内存）或用户错误（如非法的函数参数，不正确的函数使用，等等）。在这种情况下，不会向PVI管理器发送请求，也不会执行定义的响应信息。如果在数据传输过程中或在处理请求时发生错误，那么它将只与响应数据一起报告。

Description

该函数向PVI管理器发送了一个删除进程对象的请求。除非使用 PVICALLBACK_DATA 类型的回调函数，否则必须用 PviDeleteResponse 或PviXDeleteResponse函数读取响应数据。

这个函数是用来删除静态进程对象的。原则上，也可以删除临时进程对象，但这是没有必要的，因为删除进程对象是在链接对象被释放时自动进行的。

当一个进程对象被删除时，所有下级进程对象（对象层次）也被删除，所有连接的链接对象被释放。