ISimilarity::CreateTable-Methode (msrdc.h)

  • Artikel

Erstellt oder öffnet eine Tabelle mit Ähnlichkeitseigenschaften und 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 Tabellen enthalten soll. Die Ähnlichkeitsmerkmaletabelle und die Ähnlichkeitsdatei-ID-Tabelle werden in zwei alternativen Dateistreams dieser Datei erstellt. Weitere Informationen finden Sie im Pfadparameter der Methoden ISimilarityFileIdTable::CreateTable und ISimilarityTraitsTable::CreateTable .

[in] truncate

TRUE , wenn immer eine neue Ähnlichkeitseigenschaftentabelle und eine neue Ähnlichkeitsdatei-ID-Tabelle erstellt oder abgeschnitten werden sollen. Wenn FALSE angegeben ist und diese Tabellen vorhanden und gültig sind, können sie verwendet werden. Andernfalls werden alle vorhandenen Tabellen überschrieben, wenn eine der Tabellen 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 jeder Datei-ID in Bytes, die in der Tabelle mit der Ähnlichkeitsdatei-ID gespeichert werden soll. Alle Ähnlichkeitsdatei-IDs müssen dieselbe Größe aufweisen. Der gültige Bereich ist von SimilarityFileIdMinSize bis SimilarityFileIdMaxSize. Wenn vorhandene Tabellen geöffnet werden, muss der Wert dieses Parameters mit der Dateigröße der vorhandenen Ähnlichkeitsdatei-ID-Tabelle übereinstimmen. Andernfalls wird davon ausgegangen, dass die vorhandenen Tabellen ungültig sind und überschrieben werden.

[out] isNew

Ein Zeiger auf eine Variable, die einen RdcCreatedTables-Enumerationswert empfängt , der den Zustand der Tabellen beschreibt. Wenn neue Tabellen erstellt werden, empfängt diese Variable RDCTABLE_New. Wenn vorhandene Tabellen verwendet werden, 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 der Tabellen erfolgreich erstellt oder geöffnet werden kann, die andere jedoch nicht, werden beide Tabellen als ungültig markiert, und die Variable, die der isNew-Parameter empfängt, weist RDCTABLE_InvalidOrUnknown auf.

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

ISimilarity