Compartilhar via


Função SetupQueueCopyA (setupapi.h)

[Essa função está disponível para uso nos sistemas operacionais indicados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes. SetupAPI não deve mais ser usado para instalar aplicativos. Em vez disso, use o Windows Installer para desenvolver instaladores de aplicativos. SetupAPI continua a ser usado para instalar drivers de dispositivo.]

A função SetupQueueCopy adiciona uma única operação de cópia de arquivo a uma fila de arquivos de instalação.

Sintaxe

WINSETUPAPI BOOL SetupQueueCopyA(
  [in] HSPFILEQ QueueHandle,
  [in] PCSTR    SourceRootPath,
  [in] PCSTR    SourcePath,
  [in] PCSTR    SourceFilename,
  [in] PCSTR    SourceDescription,
  [in] PCSTR    SourceTagfile,
  [in] PCSTR    TargetDirectory,
  [in] PCSTR    TargetFilename,
  [in] DWORD    CopyStyle
);

Parâmetros

[in] QueueHandle

Manipular para uma fila de arquivos de instalação, conforme retornado por SetupOpenFileQueue.

[in] SourceRootPath

Ponteiro para um cadeia de caracteresterminada nula que especifica a raiz da origem dessa cópia, como A:.

[in] SourcePath

Ponteiro para uma cadeia de caracteresterminada nulo que especifica o caminho relativo a SourceRootPath em que o arquivo pode ser encontrado. Esse parâmetro pode ser NULL.

[in] SourceFilename

Ponteiro para um cadeia de caracteresterminada nula que especifica a parte do nome do arquivo a ser copiada.

[in] SourceDescription

Ponteiro para um cadeia de caracteresterminada nula que especifica uma descrição da mídia de origem a ser usada durante prompts de disco. Esse parâmetro pode ser NULL.

[in] SourceTagfile

Ponteiro para um cadeia de caracteresterminada nula que especifica um arquivo de marca cuja presença em SourceRootPath indica a presença da mídia de origem. Esse parâmetro pode ser NULL. Se não for especificado, o arquivo em si será usado como o arquivo de marca, se necessário.

[in] TargetDirectory

Ponteiro para um cadeia de caracteresterminada nula que especifica o diretório em que o arquivo deve ser copiado.

[in] TargetFilename

Ponteiro para um cadeia de caracteresterminada nula que especifica o nome do arquivo de destino. Esse parâmetro pode ser NULL. Se não for especificado, o arquivo de destino terá o mesmo nome que o arquivo de origem.

[in] CopyStyle

Especifica o comportamento da operação de cópia de arquivo. Esse parâmetro pode ser uma combinação dos valores a seguir.

SP_COPY_DELETESOURCE

Exclua o arquivo de origem após a cópia bem-sucedida. O chamador não será notificado se a exclusão falhar.

SP_COPY_REPLACEONLY

Copie o arquivo somente se isso substituir um arquivo no caminho de destino. O chamador não foi notificado.

SP_COPY_NEWER_OR MESMO

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 no dwFileVersionMS e dwFileVersionLS membros 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.

SP_COPY_NEWER_ONLY

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.

SP_COPY_NOOVERWRITE

Verifique se o arquivo de destino existe e, nesse caso, notifique o chamador que pode vetar a cópia. Se CopyMsgHandler não for especificado, o arquivo não será substituído.

SP_COPY_NODECOMP

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 de SP_COPY_NODECOMP não tiver sido especificado, o arquivo será descompactado e o destino será chamado \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.

SP_COPY_LANGUAGEAWARE

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.

SP_COPY_SOURCE_ABSOLUTE

sourceFile é um caminho de origem completo. Não pesquise na seção SourceDisksNames do arquivo INF.

SP_COPY_SOURCEPATH_ABSOLUTE

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.

SP_COPY_FORCE_IN_USE

Se o destino existir, comporte-se como se estivesse em uso e enfileira o arquivo para copiar na próxima reinicialização do sistema.

SP_COPY_IN_USE_NEEDS_REBOOT

Se o arquivo estiver em uso durante a operação de cópia, alerte o usuário de que o sistema precisa ser reinicializado.

SP_COPY_NOSKIP

Não dê ao usuário a opção de ignorar um arquivo.

SP_COPY_FORCE_NOOVERWRITE

Verifique se o arquivo de destino existe e, nesse caso, o arquivo não será substituído. O chamador não foi notificado.

SP_COPY_FORCE_NEWER

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.

SP_COPY_WARNIFSKIP

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.)

Valor de retorno

Se a função for bem-sucedida, o valor retornado será um valor diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Observações

Se um diretório UNC for especificado como o diretório de destino de uma operação de cópia de arquivo, você deverá garantir que ele exista antes que a fila seja confirmada. As funções de instalação não verificam a existência e não criam diretórios UNC. Se o diretório UNC de destino não existir, a cópia do arquivo falhará.

Nota

O cabeçalho setupapi.h define SetupQueueCopy como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho setupapi.h
biblioteca Setupapi.lib
de DLL Setupapi.dll

Consulte também

Funções

Visão geral

SetupQueueCopySection

SetupQueueDefaultCopy

SetupQueueDelete

SetupQueueRename