ISimilarityFileIdTable::CreateTableIndirect method (msrdc.h)
Creates or opens a similarity file ID table using the RDC application's implementation of the IRdcFileWriter interface.
Syntax
HRESULT CreateTableIndirect(
[in] IRdcFileWriter *fileIdFile,
[in] BOOL truncate,
[in] DWORD recordSize,
[out] RdcCreatedTables *isNew
);
Parameters
[in] fileIdFile
An IRdcFileWriter interface pointer initialized to write the file ID table to the file.
[in] truncate
TRUE if a new similarity file ID 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.
[in] recordSize
The size, in bytes, of the file IDs that will be stored in the similarity file ID table. All file IDs must be the same size. The valid range is from SimilarityFileIdMinSize to SimilarityFileIdMaxSize. If an existing similarity file ID table is being opened, the value of this parameter must match the file ID size of the existing table. Otherwise, the existing table is 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 similarity file ID 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 table is being opened, the table must be valid, and the value of the recordSize parameter must match the record size of the existing table. 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 |