Skip to content

Latest commit

 

History

History
87 lines (66 loc) · 4.43 KB

nf-msrdc-isimilarityfileidtable-createtable.md

File metadata and controls

87 lines (66 loc) · 4.43 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:msrdc.ISimilarityFileIdTable.CreateTable
ISimilarityFileIdTable::CreateTable (msrdc.h)
Creates or opens a similarity file ID table.
CreateTable
CreateTable method [Remote Differential Compression]
CreateTable method [Remote Differential Compression]
ISimilarityFileIdTable interface
ISimilarityFileIdTable interface [Remote Differential Compression]
CreateTable method
ISimilarityFileIdTable.CreateTable
ISimilarityFileIdTable::CreateTable
fs.isimilarityfileidtable_createtable
msrdc/ISimilarityFileIdTable::CreateTable
rdc.isimilarityfileidtable_createtable
rdc\isimilarityfileidtable_createtable.htm
rdc
bc683c53-5491-4cc6-abe1-c82e69aaa7f4
12/05/2018
CreateTable, CreateTable method [Remote Differential Compression], CreateTable method [Remote Differential Compression],ISimilarityFileIdTable interface, ISimilarityFileIdTable interface [Remote Differential Compression],CreateTable method, ISimilarityFileIdTable.CreateTable, ISimilarityFileIdTable::CreateTable, fs.isimilarityfileidtable_createtable, msrdc/ISimilarityFileIdTable::CreateTable, rdc.isimilarityfileidtable_createtable
msrdc.h
Windows
Windows Vista
Windows Server 2008
MsRdc.idl
MsRdc.dll
Windows
19H1
ISimilarityFileIdTable::CreateTable
msrdc/ISimilarityFileIdTable::CreateTable
c++
APIRef
kbSyntax
COM
MsRdc.dll
ISimilarityFileIdTable.CreateTable

ISimilarityFileIdTable::CreateTable

-description

Creates or opens a similarity file ID table.

-parameters

-param path [in]

A pointer to a null-terminated string that specifies the name of the file that will contain the similarity file ID table. The alternate stream name ":FileId" will be appended to the end of this file name. For more information, see Naming a File.

-param truncate [in]

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.

-param securityDescriptor [in]

A pointer to a security descriptor to use when opening the file. If this parameter is NULL, the file is assigned a default security descriptor. The access control lists (ACL) in the file's default security descriptor are inherited from the file's parent directory. For more information, see the lpSecurityAttributes parameter of the CreateFile function.

-param recordSize [in]

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.

-param isNew [out]

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.

-returns

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.

-see-also

ISimilarityFileIdTable