estrutura CF_PLACEHOLDER_CREATE_INFO (cfapi.h)

  • Artigo

Contém informações de espaço reservado para a criação de novos arquivos ou diretórios de espaço reservado.

Sintaxe

typedef struct CF_PLACEHOLDER_CREATE_INFO {
  LPCWSTR                     RelativeFileName;
  CF_FS_METADATA              FsMetadata;
  LPCVOID                     FileIdentity;
  DWORD                       FileIdentityLength;
  CF_PLACEHOLDER_CREATE_FLAGS Flags;
  HRESULT                     Result;
  USN                         CreateUsn;
} CF_PLACEHOLDER_CREATE_INFO;

Membros

RelativeFileName

O nome do arquivo ou diretório de espaço reservado filho a ser criado. Ele deve consistir apenas no nome do arquivo ou diretório.

Por exemplo, se a raiz de sincronização do provedor for C:\SyncRoot, para criar um espaço reservado chamado placeholder.txt em um subdiretório da raiz de sincronização, chame a função CfCreatePlaceholders com BaseDirectoryPath igual a C:\SyncRoot\SubDirectory e defina o campo RelativePathName do CF_PLACEHOLDER_CREATE_INFO como placeholder.txt.

FsMetadata

Metadados do sistema de arquivos a serem criados com o espaço reservado, incluindo todos os carimbos de data/hora, atributos de arquivo e tamanho do arquivo (opcional para diretórios).

FileIdentity

Um buffer de modo de usuário que contém informações de arquivo fornecidas pelo provedor de sincronização. O blob FileIdentity não deve exceder CF_PLACEHOLDER_MAX_FILE_IDENTITY_LENGTH (definido como 4 KB) de tamanho. FileIdentity é passado de volta para o provedor de sincronização em todos os retornos de chamada. Isso é necessário para arquivos (não para diretórios).

FileIdentityLength

Comprimento, em bytes, da FileIdentity.

Flags

Sinalizadores para especificar o comportamento de criação de espaço reservado. Consulte CF_PLACEHOLDER_CREATE_FLAGS para obter mais informações.

Result

O resultado da criação do espaço reservado. Na criação bem-sucedida, o valor é STATUS_OK.

CreateUsn

O valor final de USN após a criação de ações são executados.

Requisitos

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

Confira também

CF_PLACEHOLDER_CREATE_FLAGS

CfCreatePlaceholders