Connection handle that identifies the server. Connection handles are obtained with the PvConnectServer() function.
Out
pCommStatEx
Address of a PVCOMMSTATEX structure to receive the MicroKernel Engine communication statistics.
Return Values
P_OK
The operation was successful.
P_E_INVALID_HANDLE
Invalid connection handle.
P_E_COMPONENT_NOT_LOADED
Component is not loaded
P_E_NULL_PTR
Call with NULL pointer.
P_E_FAIL
Failed to disconnect to the named server.
Remarks
This function returns the same data as PvGetMkdeCommStat but uses a new structure PVCOMMSTATEX that contains two additional elements. The added elements (totalTimeouts and totalRecoveries) are related to the auto reconnect feature. See Advanced Operations Guide for more information on auto reconnect.
The following preconditions must be met:
•Connection established by PvConnectServer() or if you are performing the operation on a local machine, P_LOCAL_DB_CONNECTION may be used as the connection handle.