ISimilarityFileIdTable::CreateTable-Methode (msrdc.h)

  • Artikel

Erstellt oder öffnet eine Ähnlichkeitsdatei-ID-Tabelle.

Syntax

HRESULT CreateTable(
  [in]  wchar_t          *path,
  [in]  BOOL             truncate,
  [in]  BYTE             *securityDescriptor,
  [in]  DWORD            recordSize,
  [out] RdcCreatedTables *isNew
);

Parameter

[in] path

Ein Zeiger auf eine null-beendete Zeichenfolge, die den Namen der Datei angibt, die die Ähnlichkeitsdatei-ID-Tabelle enthält. Der alternative Streamname ":FileId" wird an das Ende dieses Dateinamens angefügt. Weitere Informationen finden Sie unter Benennen einer Datei.

[in] truncate

TRUE , wenn immer eine neue Ähnlichkeitsdatei-ID-Tabelle erstellt oder abgeschnitten werden soll. Wenn FALSE angegeben ist und die Tabelle vorhanden und gültig ist, kann sie verwendet werden. Andernfalls wird die vorhandene Tabelle überschrieben, wenn die Tabelle ungültig oder nicht vorhanden ist.

[in] securityDescriptor

Ein Zeiger auf einen Sicherheitsdeskriptor, der beim Öffnen der Datei verwendet werden soll. Wenn dieser Parameter NULL ist, wird der Datei ein Standardsicherheitsdeskriptor zugewiesen. Die Zugriffssteuerungslisten (Access Control Lists, ACL) im Standardsicherheitsdeskriptor der Datei werden vom übergeordneten Verzeichnis der Datei geerbt. Weitere Informationen finden Sie im lpSecurityAttributes-Parameter der CreateFile-Funktion .

[in] recordSize

Die Größe der Datei-IDs in Bytes, die in der Tabelle "Ähnlichkeitsdatei-ID" gespeichert werden. Alle Datei-IDs müssen die gleiche Größe aufweisen. Der gültige Bereich ist von SimilarityFileIdMinSize bis SimilarityFileIdMaxSize. Wenn eine vorhandene Ähnlichkeitsdatei-ID-Tabelle geöffnet wird, muss der Wert dieses Parameters mit der Datei-ID-Größe der vorhandenen Tabelle übereinstimmen. Andernfalls wird davon ausgegangen, dass die vorhandene Tabelle ungültig ist und überschrieben wird.

[out] isNew

Ein Zeiger auf eine Variable, die einen RdcCreatedTables-Enumerationswert empfängt , der den Zustand der Ähnlichkeitsdatei-ID-Tabelle beschreibt. Wenn eine neue Tabelle erstellt wird, empfängt diese Variable RDCTABLE_New. Wenn eine vorhandene Tabelle verwendet wird, empfängt diese Variable RDCTABLE_Existing. Wenn diese Methode fehlschlägt, empfängt diese Variable RDCTABLE_InvalidOrUnknown.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn eine vorhandene Tabelle geöffnet wird, muss die Tabelle gültig sein, und der Wert des recordSize-Parameters muss mit der Datensatzgröße der vorhandenen Tabelle übereinstimmen. Andernfalls wird die vorhandene Tabelle überschrieben, auch wenn FALSE für den Abschneidenparameter angegeben ist.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Zielplattform Windows
Kopfzeile msrdc.h
DLL MsRdc.dll

Weitere Informationen

ISimilarityFileIdTable