COPYFILE2_EXTENDED_PARAMETERS_V2 结构 (winbase.h)

包含 CopyFile2函数COPYFILE2_EXTENDED_PARAMETERS结构之外的更新的其他功能。

语法

typedef struct COPYFILE2_EXTENDED_PARAMETERS_V2 {
  DWORD                         dwSize;
  DWORD                         dwCopyFlags;
  BOOL                          *pfCancel;
  PCOPYFILE2_PROGRESS_ROUTINE   pProgressRoutine;
  PVOID                         pvCallbackContext;
  DWORD                         dwCopyFlagsV2;
  ULONG                         ioDesiredSize;
  ULONG                         ioDesiredRate;
  LPPROGRESS_ROUTINE            pProgressRoutineOld;
  PCOPYFILE2_CREATE_OPLOCK_KEYS SourceOplockKeys;
#if ...
  PVOID                         reserved[6];
#elif
  PVOID                         reserved[7];
#else
  PVOID                         reserved[8];
#endif
} COPYFILE2_EXTENDED_PARAMETERS_V2;

成员

dwSize

包含此结构 sizeof(COPYFILE2_EXTENDED_PARAMETERS_V2)的大小。

dwCopyFlags

包含零个或多个这些标志值的组合。

pfCancel

如果在复制操作期间将此标志设置为 TRUE ，则取消复制操作。

pProgressRoutine

类型 为 PCOPYFILE2_PROGRESS_ROUTINE 的回调函数的可选地址，每次复制文件的另一部分时调用该函数。 此参数可以为 NULL。 有关进度回调函数的详细信息，请参阅 CopyFile2ProgressRoutine 回调函数。 如果同时提供了 pProgressRoutineOld 和 pProgressRoutine ， 则 pProgressRoutineOld 优先。

pvCallbackContext

指向要传递给 CopyFile2ProgressRoutine 的应用程序特定上下文信息的指针。

dwCopyFlagsV2

包含零个或多个这些标志值的组合。

ioDesiredSize

可选。 每个 I/O 操作的请求大小 (字节) (即复制文件) 一个读/写周期。 如果可用内存不足，可能会减少这一点。 如果为零，则使用默认大小。 如果还提供了 ioDesiredRate ，则可能会忽略此内容

ioDesiredRate

可选。 请求的平均 I/O 速率，以千字节/秒为单位。 如果为零，则执行复制的速度会尽可能快。

pProgressRoutineOld

SourceOplockKeys

reserved[6]

reserved[7]

reserved[8]

pProgressRoutineOld。 可选。 类型 为 LPPROGRESS_ROUTINE 的旧样式回调函数的地址，每次复制文件的另一部分时都会调用该函数。 此参数可以为 NULL。 有关详细信息，请参阅进度回调函数 LPPROGRESS_ROUTINE回调。 如果同时提供了 pProgressRoutineOld 和 pProgressRoutine ， 则 pProgressRoutineOld 优先。

注解

若要编译使用此结构的应用程序，请将 _WIN32_WINNT 宏定义为 _WIN32_WINNT_WIN8 或更高版本。 有关详细信息，请参阅 使用 Windows 标头。

要求

另请参阅

CopyFile2

COPYFILE2_EXTENDED_PARAMETERS

CopyFile2ProgressRoutine

文件管理结构

LPPROGRESS_ROUTINE

使用 Windows 标头