Função PrjWritePlaceholderInfo (projectedfslib.h)

Envia metadados de arquivo ou diretório para o ProjFS.

Sintaxe

HRESULT PrjWritePlaceholderInfo(
  [in] PRJ_NAMESPACE_VIRTUALIZATION_CONTEXT namespaceVirtualizationContext,
  [in] PCWSTR                               destinationFileName,
  [in] const PRJ_PLACEHOLDER_INFO           *placeholderInfo,
  [in] UINT32                               placeholderInfoSize
);

Parâmetros

[in] namespaceVirtualizationContext

Identificador opaco para a instância de virtualização. Esse deve ser o valor do membro VirtualizationInstanceHandle do callbackData passado para o provedor no PRJ_GET_PLACEHOLDER_INFO_CB retorno de chamada.

[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 para o qual criar um espaço reservado.

Isso deve ser uma correspondência com o membro FilePathName do parâmetro callbackData passado para o provedor no retorno de chamada PRJ_GET_PLACEHOLDER_INFO_CB . O provedor deve usar a função PrjFileNameCompare para determinar se os dois nomes correspondem.

Por exemplo, se o retorno de chamada PRJ_GET_PLACEHOLDER_INFO_CB especificar "dir1\dir1\FILE.TXT" em callbackData-FilePathName> e o repositório de suporte do provedor contiver um arquivo chamado "File.txt" no diretório dir1\dir2 e PrjFileNameCompare retornará 0 ao comparar os nomes "FILE.TXT" e "File.txt", o provedor especificará "dir1\dir2\File.txt" como o valor desse parâmetro.

[in] placeholderInfo

Um ponteiro para os metadados do arquivo ou diretório.

[in] placeholderInfoSize

Tamanho em bytes do buffer apontado por placeholderInfo.

Retornar valor

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

O provedor usa essa rotina para fornecer os dados solicitados em uma invocação de seu retorno de chamada PRJ_GET_PLACEHOLDER_INFO_CB ou pode usá-lo para estabelecer proativamente um espaço reservado.

Os membros EaInformation, SecurityInformation e StreamsInformation do PRJ_PLACEHOLDER_INFO são opcionais. Se o provedor não quiser fornecer atributos estendidos, descritores de segurança personalizados ou fluxos de dados alternativos, ele deverá definir esses campos como 0.

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