Metodo ISimilarityFileIdTable::CreateTable (msrdc.h)

Crea o apre 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à la tabella ID file di somiglianza. Il nome del flusso alternativo ":FileId" verrà aggiunto alla fine di questo nome file. Per altre informazioni, vedere Denominazione di un file.

[in] truncate

TRUE se una nuova tabella ID file di somiglianza deve essere sempre creata o troncata. Se FALSE è specificato e la tabella esiste ed è valida, può essere usata; in caso contrario, se la tabella non è valida o non esiste, la tabella esistente viene sovrascritta.

[in] securityDescriptor

Puntatore a un descrittore di sicurezza da usare quando si apre il file. Se questo parametro è NULL, il 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

Le dimensioni, in byte, degli ID file che verranno archiviati nella tabella ID file di somiglianza. Tutti gli ID file devono avere le stesse dimensioni. L'intervallo valido è da SimilarityFileIdMinSize a SimilarityFileIdMaxSize. Se viene aperta una tabella ID file di somiglianza esistente, il valore di questo parametro deve corrispondere alle dimensioni ID file della tabella esistente. In caso contrario, si presuppone che la tabella esistente non sia valida e venga sovrascritto.

[out] isNew

Puntatore a una variabile che riceve un valore di enumerazione RdcCreatedTables che descrive lo stato della tabella ID file di somiglianza. Se viene creata una nuova tabella, questa variabile riceve RDCTABLE_New. Se viene usata una tabella esistente, 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 viene aperta una tabella esistente, la tabella deve essere valida e il valore del parametro recordSize deve corrispondere alle dimensioni del record della tabella esistente. In caso contrario, la tabella esistente viene sovrascritta, anche se FALSE viene specificata per il parametro tronca .

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

ISimilarityFileIdTable