Função PrjGetOnDiskFileState (projectedfslib.h)

Obtém o estado do arquivo em disco para um arquivo ou diretório.

Sintaxe

HRESULT PrjGetOnDiskFileState(
  [in]  PCWSTR         destinationFileName,
  [out] PRJ_FILE_STATE *fileState
);

Parâmetros

[in] destinationFileName

Uma cadeia de caracteres Unicode terminada em nulo especificando o caminho completo para o arquivo cujo estado deve ser consultado.

[out] fileState

Essa é uma combinação de um ou mais valores PRJ_FILE_STATE que descrevem o estado do arquivo.

Retornar valor

HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) indica que destinationFileName não existe. HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND) indica que não existe um componente intermediário do caminho para destinationFileName.

Comentários

Essa rotina informa ao chamador qual é o estado de cache do ProjFS do arquivo ou diretório especificado. Por exemplo, o chamador pode usar essa rotina para determinar se o item especificado é um espaço reservado ou um arquivo completo.

Um provedor em execução deve ser cauteloso ao usar essa rotina em arquivos ou diretórios dentro de uma de suas instâncias de virtualização, pois pode fazer com que os retornos de chamada sejam invocados no provedor. Dependendo do design do provedor, isso pode levar a deadlocks.

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