COPYFILE2_MESSAGE_ACTION-Enumeration (winbase.h)

  • Artikel

Diese Enumeration wird von der CopyFile2ProgressRoutine-Rückruffunktion zurückgegeben, um anzugeben, welche Aktion für den ausstehenden Kopiervorgang ausgeführt werden soll.

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;

Konstanten

 
COPYFILE2_PROGRESS_CONTINUE
Wert: 0
Fahren Sie mit dem Kopiervorgang fort.
COPYFILE2_PROGRESS_CANCEL
Brechen Sie den Kopiervorgang ab. Fehler beim CopyFile2-Aufruf
und zurückgeben HRESULT_FROM_WIN32(ERROR_REQUEST_ABORTED) und
alle teilweise kopierten Fragmente werden gelöscht.
COPYFILE2_PROGRESS_STOP
Beenden Sie den Kopiervorgang. Fehler beim CopyFile2-Aufruf
und zurückgeben HRESULT_FROM_WIN32(ERROR_REQUEST_ABORTED) und
alle teilweise kopierten Fragmente bleiben intakt. Der Vorgang kann mit dem
COPY_FILE_RESUME_FROM_PAUSE nur dann, wenn
COPY_FILE_RESTARTABLE Flag wurde in den dwCopyFlags festgelegt
Mitglied der
COPYFILE2_EXTENDED_PARAMETERS Struktur
an die CopyFile2-Funktion übergeben.
COPYFILE2_PROGRESS_QUIET
Fahren Sie mit dem Kopiervorgang fort, rufen Sie jedoch nicht auf
CopyFile2ProgressRoutine-Rückruffunktion
erneut für diesen Vorgang.
COPYFILE2_PROGRESS_PAUSE
Halten Sie den Kopiervorgang an, und schreiben Sie einen Neustartheader. Dieser Wert ist nicht kompatibel mit dem
COPY_FILE_RESTARTABLE Flag für das dwCopyFlags-Element von
die COPYFILE2_EXTENDED_PARAMETERS
Struktur. In den meisten Fällen schlägt der CopyFile2-Aufruf fehl und
return HRESULT_FROM_WIN32(ERROR_REQUEST_PAUSED) und any
Teilweise kopierte Fragmente bleiben intakt (mit Ausnahme des geschriebenen Headers, der zum Fortsetzen der Kopie verwendet wird
Späterer Vorgang.) Falls der Kopiervorgang zum Zeitpunkt der Verarbeitung der Pausenanforderung abgeschlossen war,
CopyFile2-Aufruf wird erfolgreich abgeschlossen, und kein Fortsetzen
header wird geschrieben. Nachdem dieser Wert verarbeitet wurde, wird ein weiterer Rückruf an die
CopyFile2ProgressRoutine mit der Nachricht
Angeben eines COPYFILE2_CALLBACK_STREAM_FINISHED (4) -Werts im
Geben Sie Einmember des
COPYFILE2_MESSAGE Struktur. Nach dem Rückruf
Zurückgegebene CopyFile2 schlägt mit fehl.
HRESULT_FROM_WIN32(ERROR_REQUEST_PAUSED).

Hinweise

Um eine Anwendung zu kompilieren, die diese Enumeration verwendet, definieren Sie das _WIN32_WINNT Makro als 0x0601 oder höher. Weitere Informationen finden Sie unter Verwenden der Windows-Header.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [Desktop-Apps | UWP-Apps]
Kopfzeile winbase.h (einschließlich Windows.h)

Weitere Informationen

CopyFile2

CopyFile2ProgressRoutine

Enumerationen in der Dateiverwaltung