COPYFILE2_MESSAGE_ACTION enumeração (winbase.h)

  • Artigo

Retornada pela função de retorno de chamada CopyFile2ProgressRoutine para indicar qual ação deve ser tomada para a operação de cópia pendente.

Syntax

typedef enum _COPYFILE2_MESSAGE_ACTION {
  COPYFILE2_PROGRESS_CONTINUE = 0,
  COPYFILE2_PROGRESS_CANCEL,
  COPYFILE2_PROGRESS_STOP,
  COPYFILE2_PROGRESS_QUIET,
  COPYFILE2_PROGRESS_PAUSE
} COPYFILE2_MESSAGE_ACTION;

Constantes

 
COPYFILE2_PROGRESS_CONTINUE
Valor: 0
Continue a operação de cópia.
COPYFILE2_PROGRESS_CANCEL
Cancele a operação de cópia. A chamada CopyFile2 falhará
e retornar HRESULT_FROM_WIN32(ERROR_REQUEST_ABORTED) e
todos os fragmentos parcialmente copiados serão excluídos.
COPYFILE2_PROGRESS_STOP
Interrompa a operação de cópia. A chamada CopyFile2 falhará
e retornar HRESULT_FROM_WIN32(ERROR_REQUEST_ABORTED) e
todos os fragmentos parcialmente copiados serão deixados intactos. A operação pode ser reiniciada usando o
COPY_FILE_RESUME_FROM_PAUSE sinalizador somente se o
COPY_FILE_RESTARTABLE sinalizador foi definido no dwCopyFlags
membro do
estrutura COPYFILE2_EXTENDED_PARAMETERS
passado para a função CopyFile2 .
COPYFILE2_PROGRESS_QUIET
Continuar a operação de cópia, mas não chamar o
Função de retorno de chamada CopyFile2ProgressRoutine
novamente para esta operação.
COPYFILE2_PROGRESS_PAUSE
Pause a operação de cópia e escreva um cabeçalho de reinicialização. Esse valor não é compatível com o
COPY_FILE_RESTARTABLE sinalizador para o membro dwCopyFlags de
o COPYFILE2_EXTENDED_PARAMETERS
Estrutura. Na maioria dos casos, a chamada CopyFile2 falhará e
return HRESULT_FROM_WIN32(ERROR_REQUEST_PAUSED) e any
fragmentos parcialmente copiados serão deixados intactos (exceto pelo cabeçalho gravado que é usado para retomar a cópia
operação posteriormente.) Caso a operação de cópia tenha sido concluída no momento em que a solicitação de pausa é processada,
A chamada copyFile2 será concluída com êxito e nenhum currículo
o cabeçalho será gravado. Depois que esse valor for processado, mais um retorno de chamada será feito para o
CopyFile2ProgressRoutine com a mensagem
especificando um valor de COPYFILE2_CALLBACK_STREAM_FINISHED (4) no
Membro de tipo do
COPYFILE2_MESSAGE estrutura. Depois que o retorno de chamada tiver
CopyFile2 retornado falhará com
HRESULT_FROM_WIN32(ERROR_REQUEST_PAUSED).

Comentários

Para compilar um aplicativo que usa essa enumeração, defina a macro _WIN32_WINNT como 0x0601 ou posterior. Para obter mais informações, consulte Usando os cabeçalhos do Windows.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
Cabeçalho winbase.h (incluir Windows.h)

Confira também

CopyFile2

CopyFile2ProgressRoutine

Enumerações de gerenciamento de arquivos