Metodo ISimilarityTraitsTable::CreateTable (msrdc.h)

Articolo
02/29/2024

Crea o apre una tabella dei tratti di somiglianza.

Sintassi

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

Parametri

[in] path

Puntatore a una stringa con terminazione Null che specifica il nome del file che conterrà la tabella dei tratti di somiglianza. Il nome del flusso alternativo ":Traits" verrà aggiunto alla fine di questo nome file. Per altre informazioni, vedere Denominazione di un file.

[in] truncate

TRUE se una nuova tabella dei tratti di somiglianza deve essere sempre creata o troncata. Se viene specificato FALSE e la tabella esiste ed è valida, può essere utilizzata; 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 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 .

[out] isNew

Puntatore a una variabile che riceve un valore di enumerazione RdcCreatedTables che descrive lo stato della tabella dei tratti 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 dei tratti di somiglianza esistente, la tabella deve essere valida. In caso contrario, la tabella esistente viene sovrascritta, anche se viene specificato FALSE per il parametro troncamento .

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

ISimilarityTraitsTable

Condividi tramite