estrutura CF_PLACEHOLDER_CREATE_INFO (cfapi.h)
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 |