PvGetTable()

PvGetTable()

Returns table attributes for a given table.

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 PvGetTable(

WORD dictHandle,

LPSTR tableName,

TABLEINFO** tableProps,

COLUMNMAP** columnList,

WORD* columnCount,

INDEXMAP** indexList,

WORD* indexCount);

Arguments

In	dictHandle	Handle of an open dictionary returned by PvOpenDatabase().
In	tableName	Name of table to retrieve.
Out	tableProps	Structure containing table information.
Out	columnList	Array of columns defined in the table.
Out	columnCount	Number of columns in columnList.
Out	indexList	Array of segments defined in the table.
Out	indexCount	Number of indexes in the indexList array.

Return Values

PCM_Success	The operation was successful.
PCM_errFailed	A general failure occurred
PCM_errMemoryAllocation	Error during memory allocation
PCM_errInvalidDictionaryHandle	The specified dictionary handle does not exist.

Remarks

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

TableProps, indexList, and columnList arrays will need to be released using PvFreeTable.