Funzione PrjDeleteFile (projectedfslib.h)

Consente a un provider di eliminare un elemento memorizzato nella cache nel file system locale.

Sintassi

HRESULT PrjDeleteFile(
  [in]            PRJ_NAMESPACE_VIRTUALIZATION_CONTEXT namespaceVirtualizationContext,
  [in]            PCWSTR                               destinationFileName,
  [in, optional]  PRJ_UPDATE_TYPES                     updateFlags,
  [out, optional] PRJ_UPDATE_FAILURE_CAUSES            *failureReason
);

Parametri

[in] namespaceVirtualizationContext

Handle opaco per l'istanza di virtualizzazione.

[in] destinationFileName

Stringa Unicode con terminazione null che specifica il percorso, rispetto alla radice di virtualizzazione, al file o alla directory da eliminare.

[in, optional] updateFlags

I flag per controllare l'operazione di eliminazione devono essere consentiti in base allo stato del file.

[out, optional] failureReason

Puntatore facoltativo per ricevere un codice che descrive il motivo per cui un'eliminazione non è riuscita.

Valore restituito

Se viene restituito un errore HRESULT_FROM_WIN32(ERROR_FILE_SYSTEM_VIRTUALIZATION_INVALID_OPERATION), l'aggiornamento non è riuscito a causa dello stato dell'elemento e del valore di updateFlags. failureReason, se specificato, descrive il motivo dell'errore.

Commenti

Se l'elemento è ancora nell'archivio di backup del provider, eliminarlo dal file system locale lo modifica in un elemento virtuale.

Questa routine non può essere chiamata in un file/directory virtuale.

Se il file/directory da eliminare è in qualsiasi stato diverso da "segnaposto", il provider deve specificare una combinazione appropriata di valori PRJ_UPDATE_TYPES nel parametro UpdateFlags. Ciò consente di proteggere la perdita accidentale dei dati.

Requisiti