estructura SP_FILE_COPY_PARAMS_A (setupapi.h)
La estructura SP_FILE_COPY_PARAMS describe una sola operación de copia de archivos.
Sintaxis
typedef struct _SP_FILE_COPY_PARAMS_A {
DWORD cbSize;
HSPFILEQ QueueHandle;
PCSTR SourceRootPath;
PCSTR SourcePath;
PCSTR SourceFilename;
PCSTR SourceDescription;
PCSTR SourceTagfile;
PCSTR TargetDirectory;
PCSTR TargetFilename;
DWORD CopyStyle;
HINF LayoutInf;
PCSTR SecurityDescriptor;
} SP_FILE_COPY_PARAMS_A, *PSP_FILE_COPY_PARAMS_A;
Miembros
cbSize
Tamaño de la estructura, en bytes. Establezca en el valor : sizeof(SP_FILE_COPY_PARAMS).
QueueHandle
Identificador de una cola de archivos de instalación, tal y como devuelve SetupOpenFileQueue.
SourceRootPath
Puntero opcional a la raíz del origen de esta copia, como A:.
SourcePath
Puntero opcional a la ruta de acceso relativa a SourceRootPath donde se puede encontrar el archivo.
SourceFilename
Parte del nombre de archivo del archivo que se va a copiar.
SourceDescription
Puntero opcional a una descripción del medio de origen que se va a usar durante las indicaciones del disco.
SourceTagfile
Puntero opcional a un archivo de etiqueta cuya presencia en SourceRootPath indica la presencia del medio de origen. Si no se especifica, el propio archivo se usará como archivo de etiqueta si es necesario.
TargetDirectory
Directorio donde se va a copiar el archivo.
TargetFilename
Puntero opcional al nombre del archivo de destino. Si no se especifica, el archivo de destino tendrá el mismo nombre que el archivo de origen.
CopyStyle
Marcas que controlan el comportamiento de la operación de copia de archivos. Estas marcas pueden ser una combinación de los valores siguientes.
| Value | Significado |
|---|---|
|
Elimine el archivo de origen tras una copia correcta. El autor de la llamada no recibe una notificación si se produce un error en la eliminación. |
|
Copie el archivo solo si lo hace, sobrescribiría un archivo en la ruta de acceso de destino. No se notifica al autor de la llamada. |
|
Examine cada archivo que se va a copiar para ver si sus recursos de versión indican que es la misma versión o no más reciente que una copia existente en el destino.
La información de versión del archivo utilizada durante las comprobaciones de versión es que se especifica en los miembros dwFileVersionMS y dwFileVersionLS de una estructura de VS_FIXEDFILEINFO , tal como se rellenan en las funciones de versión. Si uno de los archivos no tiene recursos de versión o si tienen información de versión idéntica, el archivo de origen se considera más reciente. Si el archivo de origen no es igual en la versión o posterior, y se especifica CopyMsgHandler , se notifica al autor de la llamada y se puede cancelar la copia. Si no se especifica CopyMsgHandler , el archivo no se copia. |
|
Examine cada archivo que se va a copiar para ver si sus recursos de versión indican que no es más reciente que una copia existente en el destino. Si el archivo de origen es más reciente pero no es igual a la versión del destino existente, se copia el archivo. |
|
Compruebe si el archivo de destino existe y, si es así, notifique al autor de la llamada que pueda vetar la copia. Si no se especifica CopyMsgHandler , el archivo no se sobrescribe. |
|
No descomprima el archivo. Cuando se establece esta marca, el archivo de destino no recibe la forma sin comprimir del nombre de origen (si procede). Por ejemplo, copiar f:\x86\cmd.ex_ en \\install\temp da como resultado un archivo de destino de \\install\temp\cmd.ex_. Si no se especificó la marca SP_COPY_NODECOMP, el archivo se descomprimiría y se llamaría al destino \\install\temp\cmd.exe. La parte del nombre de archivo de DestinationName, si se especifica, se quita y reemplaza por el nombre de archivo del archivo de origen. Cuando se especifica SP_COPY_NODECOMP, no se puede comprobar ninguna información de idioma o versión. |
|
Examine cada archivo que se va a copiar para ver si su idioma difiere del idioma de cualquier archivo existente que ya esté en el destino. Si es así, y se especifica CopyMsgHandler , se notifica al autor de la llamada y se puede cancelar la copia. Si no se especifica CopyMsgHandler , el archivo no se copia. |
|
SourceFile es una ruta de acceso de origen completa. No lo busque en la sección SourceDisksNames del archivo INF. |
|
SourcePathRoot es la parte de ruta de acceso completa del archivo de origen. Omita el origen relativo especificado en la sección SourceDisksNames del archivo INF del medio de origen donde se encuentra el archivo. Esta marca se omite si se especifica SP_COPY_SOURCE_ABSOLUTE. |
|
Si el destino existe, comporte como si estuviera en uso y poner en cola el archivo para copiarlo en el siguiente reinicio del sistema. |
|
Si el archivo estaba en uso durante la operación de copia, avise al usuario de que el sistema debe reiniciarse. |
|
No proporcione al usuario la opción de omitir un archivo. |
|
Compruebe si el archivo de destino existe y, si es así, el archivo no se sobrescribe. No se notifica al autor de la llamada. |
|
Examine cada archivo que se va a copiar para ver si sus recursos de versión (o marcas de tiempo para archivos que no son de imagen) indican que no es más reciente que una copia existente en el destino. Si el archivo que se copia no es más reciente, el archivo no se copia. No se notifica al autor de la llamada. |
|
Si el usuario intenta omitir un archivo, avisa de que omitir un archivo puede afectar a la instalación. (Se usa para archivos críticos del sistema). |
LayoutInf
Controle al INF que se va a usar para obtener información de origen.
SecurityDescriptor
Cadena de descriptor de seguridad opcional que especifica la ACL que se va a aplicar al archivo.
Comentarios
Nota:
El encabezado setupapi.h define SP_FILE_COPY_PARAMS como un alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
Requisitos
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Encabezado | setupapi.h |