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

Definition for C/C++

int PviCreate (LPDWORD pLinkID, LPCSTR pObjectName, DWORD ObjectTyp, LPCSTR pObjektDescriptor, LPVOID hEventMsg, DWORD EventMsgNo, LPARAM EventParam, LPCSTR pLinkDescriptor)

int PviXCreate (DWORD hPvi, LPDWORD pLinkID, LPCSTR pObjectName, DWORD ObjectTyp, LPCSTR pObjektDescriptor, LPVOID hEventMsg, DWORD EventMsgNo, LPARAM EventParam, LPCSTR pLinkDescriptor)

Definition for Basic

PviCreate (ByRef pLinkID As Long, ByVal pObjectName As String, ByVal ObjectType As Long, ByVal pObjectDescriptor As String, ByVal hEventMsg As Long, ByVal EventMsgNo As Long, ByVal EventParam As Long, ByVal pLinkDescriptor As String) As Long

PviXCreate (ByVal hPvi As Long, ByRef pLinkID As Long, ByVal pObjectName As String, ByVal ObjectType As Long, ByVal pObjectDescriptor As String, ByVal hEventMsg As Long, ByVal EventMsgNo As Long, ByVal EventParam As Long, ByVal pLinkDescriptor As String) As Long

Arguments

Argument	I/O	Description
hPvi	In	来自 PviXInitialize 函数的实例句柄
pLinkID	Out	指向用于记录链接ID的变量的指针（只有在设置了链接对象时才需要）。
pObjectName	In	指向对象名称或对象路径名称的指针。以空结尾的字符串形式给出。
ObjectType	In	对象类型条目。 pobj_line, pobj_device, pobj_station, pobj_cpu, pobj_modul, pobj_task, pobj_pvar。如果对象类型是用pObjectName（"OT "参数）中的对象名称指定的，那么这里给出的对象类型就不重要了。
pObjectDescriptor	In	指向进程对象描述的指针。以空结尾的字符串形式给出。
hEventMsg	In	用户信息的定义，它被分配给链接对象，用于传递事件数据（事件）的信号。如果hEventMsg不等于0（空），那么将建立一个临时进程对象和一个链接对象。如果hEventMsg等于0（零），那么就会建立一个没有链接对象的静态进程对象。
EventMsgNo	In	用户信息的信息编号 = 0 (Null)。在这种情况下，可以为hEventMsg指定0（零）或任何不等于0的值（例如，PVI_HMSG_NIL），没有为事件数据分配用户消息。
EventParam	In	用户信息的消息参数在32位PVI版本（PviCom.dll）中，消息参数（用户参数）的大小为4字节，在64位PVI版本（PviCom64.dll）中为8字节。
pLinkDescriptor	In	指向链接对象描述的指针。以空结尾的字符串形式给出。

Return value

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

Description