enumeração CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAGS (cfapi.h)

Sinalizadores para especificar o comportamento ao transferir um arquivo ou diretório de espaço reservado.

Sintaxe

typedef enum CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAGS {
  CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_NONE = 0x00000000,
  CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_STOP_ON_ERROR = 0x00000001,
  CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION = 0x00000002
} ;

Constants

CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_NONE Valor: 0x00000000 Nenhum sinalizador de espaço reservado de transferência.
CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_STOP_ON_ERROR Valor: 0x00000001 Faz com que a API retorne imediatamente se uma transferência de espaço reservado falhar. Se uma transferência falhar, o código de erro será retornado.
CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION Valor: 0x00000002 Desabilita a população sob demanda para o diretório, impedindo mais CF_CALLBACK_TYPE_FETCH_PLACEHOLDERS retornos de chamada. IMPORTANTE Sem esse sinalizador, o retorno de chamada dos espaços reservados de transferência será invocado repetidamente (potencialmente mais de 100 vezes) à medida que o sistema continuar solicitando espaços reservados sob demanda. Os provedores devem definir esse sinalizador para indicar que todos os espaços reservados foram criados e nenhum retorno de chamada adicional é necessário. Quando o provedor terminar de criar todos os espaços reservados em um diretório, ele deverá marcar o diretório como totalmente preenchido definindo o sinalizador CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION . Isso impede que o retorno de chamada CF_CALLBACK_TYPE_FETCH_PLACEHOLDERS seja invocado novamente para esse diretório. Normalmente, um provedor deve definir esse sinalizador depois de ter colocado todos os espaços reservados no diretório ou se a invocação atual de CF_OPERATION_TYPE_TRANSFER_PLACEHOLDERS deve criar todos os espaços reservados restantes. O provedor pode definir esse sinalizador a qualquer momento e será respeitado pela plataforma se durante a invocação atual de CF_OPERATION_TYPE_TRANSFER_PLACEHOLDERS: 1. TransferPlaceholders.PlaceholderTotalCount<= (Soma de Anterior TransferPlaceholders.EntriesProcessed) + Atual TransferPlaceholders.PlaceholderCount. 1. Todos os espaços reservados atuais TransferPlaceholders.PlaceholderCount são criados com êxito. Por exemplo, se um provedor precisar transferir dez espaços reservados, ele poderá transferir e definir CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION de uma das maneiras a seguir. Ele poderia fazer isso: 1. DefinirTransferPlaceholders.PlaceholderTotalCount5 = , definir4 = TransferPlaceholders.PlaceholderCount e definir Flags como .NONE 1. DefinirTransferPlaceholders.PlaceholderTotalCount9 = , definir4 = TransferPlaceholders.PlaceholderCount e definir Flags como .NONE 1. DefinirTransferPlaceholders.PlaceholderTotalCount11 = , definir2 = TransferPlaceholders.PlaceholderCount e definir Flags como .NONE 1. DefinirTransferPlaceholders.PlaceholderTotalCount10 = , definir0 = TransferPlaceholders.PlaceholderCount e definir Flags como .CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION Ou pode fazer o seguinte: 1. DefinirTransferPlaceholders.PlaceholderTotalCount5 = , definir4 = TransferPlaceholders.PlaceholderCount e definir Flags como .NONE 1. DefinirTransferPlaceholders.PlaceholderTotalCount9 = , definir4 = TransferPlaceholders.PlaceholderCount e definir Flags como .NONE 1. DefinirTransferPlaceholders.PlaceholderTotalCount10 = , definir2 = TransferPlaceholders.PlaceholderCount e definir Flags como .CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION

Requirements

Requirement	Value
Cliente mínimo suportado	Windows 10, versão 1709 [somente aplicativos da área de trabalho]
Servidor mínimo compatível	Windows Server 2016 [somente aplicativos da área de trabalho]
Header	cfapi.h

Consulte também

CF_CALLBACK_TYPE

CF_OPERATION_TYPE

CfExecute