Função SetupDecompressOrCopyFileA (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 SetupDecompressOrCopyFile copia um arquivo, descompactando-o, se necessário.
Se um arquivo for copiado, o chamador dessa função precisará ter privilégios para gravar no diretório de destino.
Sintaxe
WINSETUPAPI DWORD SetupDecompressOrCopyFileA(
[in] PCSTR SourceFileName,
[in] PCSTR TargetFileName,
[in] PUINT CompressionType
);
Parâmetros
[in] SourceFileName
Nome do arquivo a ser copiado. Você deve usar uma cadeia de caracteresterminada
[in] TargetFileName
Nome exato do arquivo de destino que será criado descompactando ou copiando o arquivo de origem. Você deve usar uma cadeia de caracteresterminada
[in] CompressionType
Ponteiro opcional para o tipo de compactação usado no arquivo de origem. Você pode determinar o tipo de compactação chamando SetupGetFileCompressionInfo. Se esse valor for FILE_COMPRESSION_NONE, o arquivo será copiado (não descompactado), independentemente de qualquer compactação em uso na origem. Se CompressionType não for especificado, essa rotina determinará o tipo de compactação automaticamente.
Valor de retorno
A função
Para obter informações de erro estendidas, chame GetLastError.
Observações
Nota
O cabeçalho setupapi.h define SetupDecompressOrCopyFile 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 |