Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This I/O control is called by a user application to copy from or to an external device.

Parameters

hFile

[in] Handle to a file received from the CreateFilefunction.

dwIoControlCode

[in] Set to FSCTL_COPY_EXTERNAL.

lpInBuf

[in] Pointer to a FILE_COPY_EXTERNALstructure.

nInBufSize

[in] Size of the input buffer.

lpOutBuf

[out] Not used.

nOutBufSize

[in] Not used.

lpBytesReturned

[out] Not used.

Return Values

A nonzero value indicates success. Zero indicates failure.

Remarks

The caller of FSCTL_COPY_EXTERNALshould use a mapped pointer for pUserDatain the FILE_COPY_EXTERNALstructure. The caller of this I/O control should also set cbSectorListSizeto zero.

Requirements

Header fsioctl.h
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also