Compartilhar via

Função PrjDeleteFile (projectedfslib.h)

  • Artigo

Permite que um provedor exclua um item que foi armazenado em cache no sistema de arquivos local.

Sintaxe

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

Parâmetros

[in] namespaceVirtualizationContext

Um identificador opaco para a instância de virtualização.

[in] destinationFileName

Uma cadeia de caracteres Unicode terminada em nulo especificando o caminho, em relação à raiz de virtualização, para o arquivo ou diretório a ser excluído.

[in, optional] updateFlags

Os sinalizadores para controlar a operação de exclusão devem ser permitidos considerando o estado do arquivo.

[out, optional] failureReason

Ponteiro opcional para receber um código que descreve o motivo pelo qual uma exclusão falhou.

Retornar valor

Se um erro de HRESULT_FROM_WIN32(ERROR_FILE_SYSTEM_VIRTUALIZATION_INVALID_OPERATION) for retornado, a atualização falhará devido ao estado do item e ao valor de updateFlags. failureReason, se especificado, descreverá o motivo da falha.

Comentários

Se o item ainda estiver no repositório de backup do provedor, excluí-lo do sistema de arquivos local o alterará para um item virtual.

Essa rotina não pode ser chamada em um arquivo/diretório virtual.

Se o arquivo/diretório a ser excluído estiver em qualquer estado diferente de "espaço reservado", o provedor deverá especificar uma combinação apropriada de valores de PRJ_UPDATE_TYPES no parâmetro updateFlags. Isso ajuda a proteger contra perda acidental de dados.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1809 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho projectedfslib.h