Compartilhar via

enumeração CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAGS (cfapi.h)

  • Artigo

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

Syntax

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
} ;

Constantes

 
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
Se o provedor não quiser mais que seu retorno de chamada CF_CALLBACK_TYPE_FETCH_PLACEHOLDERS seja invocado, ele deverá marcar o diretório de espaço reservado totalmente preenchido definindo o sinalizador de CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION em CF_OPERATION_TYPE_TRANSFER_PLACEHOLDERS. Normalmente, um provedor deve definir esse sinalizador depois de já ter estabelecido todos os espaços reservados no diretório ou se a invocação atual de CF_OPERATION_TYPE_TRANSFER_PLACEHOLDERS deve estabelecer todos os espaços reservados. O provedor pode definir esse sinalizador a qualquer momento e ele 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.
2. 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. Defina TransferPlaceholders.PlaceholderTotalCount = 5, defina TransferPlaceholders.PlaceholderCount4 = e defina Flags como .NONE
2. Defina TransferPlaceholders.PlaceholderTotalCount = 9, defina TransferPlaceholders.PlaceholderCount4 = e defina Flags como .NONE
3. Defina TransferPlaceholders.PlaceholderTotalCount = 11, defina TransferPlaceholders.PlaceholderCount2 = e defina Flags como .NONE
4. Defina TransferPlaceholders.PlaceholderTotalCount = 10, defina TransferPlaceholders.PlaceholderCount0 = e defina Flags como .CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION

Ou pode fazer o seguinte:

1. Defina TransferPlaceholders.PlaceholderTotalCount = 5, defina TransferPlaceholders.PlaceholderCount4 = e defina Flags como .NONE
2. Defina TransferPlaceholders.PlaceholderTotalCount = 9, defina TransferPlaceholders.PlaceholderCount4 = e defina Flags como .NONE
3. Defina TransferPlaceholders.PlaceholderTotalCount = 10, defina TransferPlaceholders.PlaceholderCount2 = e defina Flags como .CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION

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_CALLBACK_TYPE

CF_OPERATION_TYPE

CfExecute