> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IXtfCopyFileCallback::OnStartFileCopy (método)

> IXtfCopyFileCallback::OnStartFileCopy (método)

# IXtfCopyFileCallback::OnStartFileCopy (método)

Se llama cuando un archivo empieza a copiarse entre dos ubicaciones de una consola de desarrollo.

<a id="syntaxSection" />

## Sintaxis

```cpp theme={null}
public:
HRESULT OnStartFileCopy(
         LPCWSTR pszRootDirectory,
         LPCWSTR pszSearchPattern,
         LPCXTFFILEINFO pSrcFileInfo,
         LPCWSTR pszDstFileName
)  
```

<a id="parametersSection" />

### Parámetros

*pszRootDirectory*\
Tipo: LPCWSTR

Puntero a la ruta de acceso del directorio raíz para la copia.

*pszSearchPattern*\
Tipo: LPCWSTR

Puntero al patrón de búsqueda que define los nombres de archivo de los archivos de origen que se van a copiar. Este parámetro acepta caracteres comodín para hacer coincidir cadenas con el patrón indicado.

*pSrcFileInfo*\
Tipo: LPCXTFFILEINFO

Puntero a una estructura [XTFFILEINFO](/reference/tools/xtf/xtffileio/structures/xtffileinfo-xtffileio-xbox-microsoft-t) que contiene información sobre el archivo copiado.

*pszDstFileName*\
Tipo: LPCWSTR

Puntero al nombre de archivo del archivo de destino.

<a id="retvalSection" />

### Valor devuelto

Tipo: HRESULT

Devuelve `S_OK` si se realiza correctamente; de lo contrario, devuelve un código de error HRESULT.

<a id="remarksSection" />

## Comentarios

Esta función de devolución de llamada es llamada una vez por el método [IXtfFileIOClient::CopyFiles](/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/copyfiles-ixtffileioclient-xtffileio-xbox-microsoft-m) al principio de una operación de copia de archivos. El tamaño de archivo devuelto en la estructura [XTFFILEINFO](/reference/tools/xtf/xtffileio/structures/xtffileinfo-xtffileio-xbox-microsoft-t) representa la suma del tamaño de los archivos que se deben copiar, en bytes. Puede usar esta suma para hacer un seguimiento del progreso general de la operación de copia de archivos. Si esta función de devolución de llamada devuelve un código de error HRESULT, la operación de copia de archivos se anula.

<a id="requirementsSection" />

## Requisitos

**Encabezado:** xtffileio.h

**Biblioteca:** xtffileio.lib

**Plataformas compatibles:** Windows (para herramientas de consola XBOX)

<a id="seealsoSection" />

## Consulte también

[IXtfCopyFileCallback (interfaz)](/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/ixtfcopyfilecallback-xtffileio-xbox-microsoft-t)\
[XtfFileIO](/reference/tools/xtf/xtffileio/xtffileio-xbox-microsoft-n)


## Related topics

- [IXtfCopyFileCallback::OnEndFileCopy (método)](/es/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onendfilecopy-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [IXtfCopyFileCallback::OnFileCopyProgress (método)](/es/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onfilecopyprogress-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [IXtfFileIOClient::CopyFiles (método)](/es/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/copyfiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md)
- [IXtfBatchFileIOClient::CopyFiles (método)](/es/reference/tools/xtf/xtffileio/classes/IXtfBatchFileIOClient/methods/copyfiles-ixtfbatchfileioclient-xtffileio-xbox-microsoft-m.md)
- [XTFFILEINFO](/es/reference/tools/xtf/xtffileio/structures/xtffileinfo-xtffileio-xbox-microsoft-t.md)