estrutura SP_FILE_COPY_PARAMS_A (setupapi.h)
A estrutura SP_FILE_COPY_PARAMS descreve uma única operação de cópia de arquivo.
Sintaxe
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;
Membros
cbSize
Tamanho da estrutura, em bytes. Defina como o valor: sizeof(SP_FILE_COPY_PARAMS).
QueueHandle
Manipule para uma fila de arquivos de instalação, conforme retornado por SetupOpenFileQueue.
SourceRootPath
Ponteiro opcional para a raiz da origem dessa cópia, como A:.
SourcePath
Ponteiro opcional para o caminho relativo a SourceRootPath em que o arquivo pode ser encontrado.
SourceFilename
Parte do nome do arquivo a ser copiado.
SourceDescription
Ponteiro opcional para uma descrição da mídia de origem a ser usada durante prompts de disco.
SourceTagfile
Ponteiro opcional para um arquivo de marca cuja presença em SourceRootPath indica a presença da mídia de origem. Se não for especificado, o arquivo em si será usado como o arquivo de marca, se necessário.
TargetDirectory
Diretório em que o arquivo deve ser copiado.
TargetFilename
Ponteiro opcional para o nome do arquivo de destino. Se não for especificado, o arquivo de destino terá o mesmo nome que o arquivo de origem.
CopyStyle
Sinalizadores que controlam o comportamento da operação de cópia de arquivo. Esses sinalizadores podem ser uma combinação dos valores a seguir.
| Valor | Significado |
|---|---|
|
Exclua o arquivo de origem após a cópia bem-sucedida. O chamador não será notificado se a exclusão falhar. |
|
Copie o arquivo somente se isso substituir um arquivo no caminho de destino. O chamador não foi notificado. |
|
Examine cada arquivo que está sendo copiado para ver se seus recursos de versão indicam que ele é a mesma versão ou não mais recente do que uma cópia existente no destino.
As informações de versão do arquivo usadas durante as verificações de versão são especificadas nos membros dwFileVersionMS e dwFileVersionLS de uma estrutura VS_FIXEDFILEINFO , conforme preenchido pelas funções de versão. Se um dos arquivos não tiver recursos de versão ou se tiverem informações de versão idênticas, o arquivo de origem será considerado mais recente. Se o arquivo de origem não for igual na versão ou mais recente e CopyMsgHandler for especificado, o chamador será notificado e poderá cancelar a cópia. Se CopyMsgHandler não for especificado, o arquivo não será copiado. |
|
Examine cada arquivo que está sendo copiado para ver se seus recursos de versão indicam que ele não é mais recente do que uma cópia existente no destino. Se o arquivo de origem for mais recente, mas não for igual na versão para o destino existente, o arquivo será copiado. |
|
Verifique se o arquivo de destino existe e, em caso afirmativo, notifique o chamador que pode vetar a cópia. Se CopyMsgHandler não for especificado, o arquivo não será substituído. |
|
Não descompacte o arquivo. Quando esse sinalizador é definido, o arquivo de destino não recebe a forma descompactada do nome de origem (se apropriado). Por exemplo, copiar f:\x86\cmd.ex_ para \\install\temp resulta em um arquivo de destino de \\install\temp\cmd.ex_. Se o sinalizador SP_COPY_NODECOMP não fosse especificado, o arquivo seria descompactado e o destino seria chamado de \\install\temp\cmd.exe. A parte do nome do arquivo de DestinationName, se especificada, é removida e substituída pelo nome do arquivo de origem. Quando SP_COPY_NODECOMP é especificado, nenhuma informação de idioma ou versão pode ser verificada. |
|
Examine cada arquivo que está sendo copiado para ver se seu idioma difere do idioma de qualquer arquivo existente já no destino. Nesse caso, e CopyMsgHandler for especificado, o chamador será notificado e poderá cancelar a cópia. Se CopyMsgHandler não for especificado, o arquivo não será copiado. |
|
SourceFile é um caminho de origem completo. Não pesquise na seção SourceDisksNames do arquivo INF. |
|
SourcePathRoot é a parte completa do caminho do arquivo de origem. Ignore a fonte relativa especificada na seção SourceDisksNames do arquivo INF para a mídia de origem em que o arquivo está localizado. Esse sinalizador será ignorado se SP_COPY_SOURCE_ABSOLUTE for especificado. |
|
Se o destino existir, comporte-se como se estivesse em uso e enfileirar o arquivo para copiar na próxima reinicialização do sistema. |
|
Se o arquivo estiver em uso durante a operação de cópia, alerte o usuário de que o sistema precisa ser reinicializado. |
|
Não dê ao usuário a opção de ignorar um arquivo. |
|
Verifique se o arquivo de destino existe e, em caso afirmativo, o arquivo não é substituído. O chamador não foi notificado. |
|
Examine cada arquivo que está sendo copiado para ver se seus recursos de versão (ou carimbos de data/hora para arquivos que não são de imagem) indicam que ele não é mais recente do que uma cópia existente no destino. Se o arquivo que está sendo copiado não for mais recente, o arquivo não será copiado. O chamador não foi notificado. |
|
Se o usuário tentar ignorar um arquivo, avise-o de que ignorar um arquivo pode afetar a instalação. (Usado para arquivos críticos do sistema.) |
LayoutInf
Manipule para o INF a ser usado para obter informações de origem.
SecurityDescriptor
Uma cadeia de caracteres de descritor de segurança opcional que especifica a ACL a ser aplicada ao arquivo.
Comentários
Observação
O cabeçalho setupapi.h define SP_FILE_COPY_PARAMS como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Cabeçalho | setupapi.h |