PvGetTableNames()

PvGetTableNames()

Returns table names of all the tables in the open data dictionary.

Header File: ddf.h (See also Header Files)

Function First Available In Library: w3dbav75.dll (Windows), libpsqldti.so (Linux), libpsqldti.dylib (macOS) (See also Link Libraries)

Syntax

PRESULT PvGetTableNames(

WORD dictHandle,

TABLEMAP** tableList,

WORD* tableCount);

Arguments

In	dictHandle	Handle of an open dictionary returned by PvOpenDatabase().
Out	tableList	Array of TABLEMAP structures that contain table names.
Out	tableCount	Number of table names returned in tableList.

Return Values

PCM_Success	The operation was successful.
PCM_errFailed	The operation was not successful.
PCM_errMemoryAllocation	An error occurred during memory allocation.
PCM_errInvalidDictionaryHandle	The specified dictionary handle obtained by PvOpenDatabase() is invalid.

Remarks

You must first open a dictionary successfully using PvOpenDatabase().

TableList array will need to be released using PvFreeTableNames().

You can retrieve more information about a specific table using PvGetTable().