Metodo ISimilarity::CreateTable (msrdc.h)

Crea o apre una tabella dei tratti di somiglianza e una tabella ID file di somiglianza.

Sintassi

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

Parametri

[in] path

Puntatore a una stringa con terminazione Null che specifica il nome del file che conterrà le tabelle. La tabella dei tratti di somiglianza e la tabella ID file di somiglianza verranno create in due flussi di file alternativi di questo file. Per altre informazioni, vedere il parametro path dei metodi ISimilarityFileIdTable::CreateTable e ISimilarityTraitsTable::CreateTable .

[in] truncate

TRUE se deve essere creata o troncata una nuova tabella di caratteristiche di somiglianza e una nuova tabella ID file di somiglianza. Se viene specificato FALSE e queste tabelle esistono e sono valide, possono essere usate; in caso contrario, se una delle tabelle non è valida o non esiste, le tabelle esistenti vengono sovrascritte.

[in] securityDescriptor

Puntatore a un descrittore di sicurezza da usare durante l'apertura del file. Se questo parametro è NULL, al file viene assegnato un descrittore di sicurezza predefinito. Gli elenchi di controllo di accesso (ACL) nel descrittore di sicurezza predefinito del file vengono ereditati dalla directory padre del file. Per altre informazioni, vedere il parametro lpSecurityAttributes della funzione CreateFile .

[in] recordSize

Dimensione, in byte, di ogni ID file da archiviare nella tabella id file di somiglianza. Tutti gli ID di file di somiglianza devono avere le stesse dimensioni. L'intervallo valido è compreso tra SimilarityFileIdMinSize e SimilarityFileIdMaxSize. Se le tabelle esistenti vengono aperte, il valore di questo parametro deve corrispondere alla dimensione ID file della tabella ID file di somiglianza esistente. In caso contrario, si presuppone che le tabelle esistenti non siano valide e vengano sovrascritte.

[out] isNew

Puntatore a una variabile che riceve un valore di enumerazione RdcCreatedTables che descrive lo stato delle tabelle. Se vengono create nuove tabelle, questa variabile riceve RDCTABLE_New. Se vengono usate tabelle esistenti, questa variabile riceve RDCTABLE_Existing. Se questo metodo ha esito negativo, questa variabile riceve RDCTABLE_InvalidOrUnknown.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Se una delle tabelle può essere creata o aperta correttamente, ma l'altra non può, entrambe le tabelle sono contrassegnate come non valide e la variabile che il parametro isNew punta a ricevere RDCTABLE_InvalidOrUnknown.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	msrdc.h
DLL	MsRdc.dll

Vedi anche

ISimilarity