ISimilarityTraitsTable::CreateTableIndirect method (msrdc.h)

Creates or opens a similarity traits table using the RDC application's implementation of the ISimilarityTraitsMapping interface.

Syntax

HRESULT CreateTableIndirect(
  [in]  ISimilarityTraitsMapping *mapping,
  [in]  BOOL                     truncate,
  [out] RdcCreatedTables         *isNew
);

Parameters

[in] mapping

An ISimilarityTraitsMapping interface pointer initialized to write the similarity traits table to the file.

[in] truncate

TRUE if a new similarity traits table should always be created or truncated. If FALSE is specified and the table exists and is valid, it may be used; otherwise, if the table is not valid or does not exist, the existing table is overwritten.

[out] isNew

A pointer to a variable that receives an RdcCreatedTables enumeration value that describes the state of the similarity traits table. If a new table is created, this variable receives RDCTABLE_New. If an existing table is used, this variable receives RDCTABLE_Existing. If this method fails, this variable receives RDCTABLE_InvalidOrUnknown.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

If an existing similarity traits table is being opened, the table must be valid. Otherwise, the existing table is overwritten, even if FALSE is specified for the truncate parameter.

Requirements

Requirement Value
Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
Target Platform Windows
Header msrdc.h
DLL MsRdc.dll

See also

ISimilarityTraitsTable