Edit

ISimilarity::CreateTableIndirect method (msrdc.h)

  • Article

Creates or opens a similarity traits table and a similarity file ID table using the RDC application's implementations of the ISimilarityTraitsMapping and IRdcFileWriter interfaces.

Syntax

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

Parameters

[in] mapping

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

[in] fileIdFile

An IRdcFileWriter interface pointer initialized to write the file ID table to the file.

[in] truncate

TRUE if a new similarity traits table and a new similarity file ID table should always be created or truncated. If FALSE is specified and these tables exist and are valid, they may be used; otherwise, if one of the tables is not valid or does not exist, any existing tables are overwritten.

[in] recordSize

The size, in bytes, of each file ID to be stored in the similarity file ID table. All similarity file IDs must be the same size. The valid range is from SimilarityFileIdMinSize to SimilarityFileIdMaxSize. If existing tables are being opened, the value of this parameter must match the file ID size of the existing similarity file ID table. Otherwise, the existing tables are assumed to be not valid and will be overwritten.

[out] isNew

A pointer to a variable that receives an RdcCreatedTables enumeration value that describes the state of the tables. If new tables are created, this variable receives RDCTABLE_New. If existing tables are 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 one of the tables can be created or opened successfully, but the other one cannot, both tables are marked as not valid, and the variable that the isNew parameter points to receives RDCTABLE_InvalidOrUnknown.

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

ISimilarity