COPYFILE2_MESSAGE_ACTION-Enumeration (winbase.h)

Artikel
08/27/2023

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

Freigeben über