ISimilarityTraitsTable::CreateTable-Methode (msrdc.h)

  • Artikel

Erstellt oder öffnet eine Tabelle mit Ähnlichkeitsmerkmalen.

Syntax

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

Parameter

[in] path

Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Namen der Datei angibt, die die Tabelle mit ähnlichkeitsbezogenen Merkmalen enthält. Der alternative Streamname ":Traits" wird am Ende dieses Dateinamens angefügt. Weitere Informationen finden Sie unter Benennen einer Datei.

[in] truncate

TRUE , wenn immer eine neue Ähnlichkeitseigenschaftentabelle 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 .

[out] isNew

Ein Zeiger auf eine Variable, die einen RdcCreatedTables-Enumerationswert empfängt , der den Zustand der Ähnlichkeitsmerkmaletabelle beschreibt. Wenn eine neue Tabelle erstellt wird, erhält 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 mit Ähnlichkeitsmerkmalen geöffnet wird, muss die Tabelle gültig sein. 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

ISimilarityTraitsTable