SetupDecompressOrCopyFileW, fonction (setupapi.h)
[Cette fonction est disponible pour une utilisation dans les systèmes d’exploitation indiqués dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions ultérieures. SetupAPI ne doit plus être utilisé pour installer des applications. Utilisez plutôt Windows Installer pour développer des programmes d’installation d’applications. SetupAPI continue d’être utilisé pour installer des pilotes de périphérique.]
La fonction SetupDecompressOrCopyFile copie un fichier, le décompressant si nécessaire.
Si un fichier est copié, l’appelant de cette fonction doit disposer de privilèges d’écriture dans le répertoire cible.
Syntaxe
WINSETUPAPI DWORD SetupDecompressOrCopyFileW(
[in] PCWSTR SourceFileName,
[in] PCWSTR TargetFileName,
[in] PUINT CompressionType
);
Paramètres
[in] SourceFileName
Nom du fichier à copier. Vous devez utiliser une chaîne null-terminated. Ce paramètre peut être NULL. Si CompressionType n’est pas spécifié et que la fonction SetupDecompressOrCopyFile ne trouve pas le fichier spécifié dans SourceFileName, la fonction recherche le fichier avec jusqu’à deux noms de « formulaire compressé ». Par exemple, si le fichier est F:\x86\cmd.exe et qu’il est introuvable, la fonction recherche F :\x86\cmd.ex_ et, si elle est introuvable, F :\x86\cmd.ex$ est recherchée. Si compressionType est spécifié, aucun traitement supplémentaire n’est effectué sur le nom de fichier ; le fichier doit exister exactement comme spécifié ou la fonction échoue.
[in] TargetFileName
Nom exact du fichier cible qui sera créé en décompressant ou en copiant le fichier source. Vous devez utiliser une chaîne null-terminated.
[in] CompressionType
Pointeur facultatif vers le type de compression utilisé dans le fichier source. Vous pouvez déterminer le type de compression en appelant SetupGetFileCompressionInfo. Si cette valeur est FILE_COMPRESSION_NONE, le fichier est copié (non compressé), quelle que soit la compression utilisée sur la source. Si CompressionType n’est pas spécifié, cette routine détermine automatiquement le type de compression.
Valeur de retour
La fonction SetupDecompressOrCopyFile retourne un code d’erreur système qui indique le résultat de l’opération.
Pour obtenir des informations d’erreur étendues, appelez GetLastError.
Remarques
Note
L’en-tête setupapi.h définit SetupDecompressOrCopyFile comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows XP [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | setupapi.h |
| bibliothèque | Setupapi.lib |
| DLL | Setupapi.dll |