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 (OS X) (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.
See Also
PvStart()
PvOpenDatabase()
PvGetTableNames()
PvFreeTable()
PvFreeTableNames()
PvCloseDictionary()
PvStop()