SetupGetSourceFileSizeA, fonction (setupapi.h)
[Cette fonction peut être utilisée dans les systèmes d’exploitation indiqués dans la section Configuration requise. Il sera 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 les pilotes de périphérique.]
La fonction SetupGetSourceFileSize lit la taille non compressée d’un fichier source répertorié dans un fichier INF.
Syntaxe
WINSETUPAPI BOOL SetupGetSourceFileSizeA(
[in] HINF InfHandle,
[in] PINFCONTEXT InfContext,
[in] PCSTR FileName,
[in] PCSTR Section,
[in, out] PDWORD FileSize,
[in] UINT RoundingFactor
);
Paramètres
[in] InfHandle
Gérez le fichier INF chargé qui contient les sections SourceDisksNames et SourceDisksFiles . Si des sections spécifiques à la plateforme existent pour le système de l’utilisateur (par exemple, SourceDisksNames.x86 et SourceDisksFiles.x86), la section spécifique à la plateforme est utilisée.
[in] InfContext
Pointeur facultatif vers un contexte pour une ligne d’une section Copier des fichiers pour laquelle la taille doit être récupérée. Si InfContext a la valeur NULL, le paramètre FileName est utilisé.
[in] FileName
Pointeur facultatif vers une chaîne terminée par un caractère Null contenant le nom de fichier (aucun chemin) pour lequel retourner la taille. Si ce paramètre a la valeur NULL et InfContext, le paramètre Section est utilisé.
[in] Section
Pointeur facultatif vers une chaîne terminée par null contenant le nom d’une section Copier des fichiers . Si ce paramètre est spécifié, la taille totale de tous les fichiers répertoriés dans la section est calculée.
[in, out] FileSize
Pointeur vers une variable qui reçoit la taille, en octets, du ou des fichiers spécifiés.
[in] RoundingFactor
Valeur facultative pour arrondir les tailles de fichier. Toutes les tailles de fichier sont arrondies à un multiple de ce nombre avant d’être ajoutées à la taille totale. L’arrondi est utile pour déterminer plus exactement l’espace qu’un fichier occupera sur un volume donné, car il permet à l’appelant d’avoir des tailles de fichier arrondies à un multiple de la taille du cluster. L’arrondi ne se produit que si RoundingFactor est spécifié.
Valeur retournée
Si la fonction réussit, la valeur de retour est une valeur différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
Un seul des paramètres facultatifs, InfContext, FileName et Section, doit être spécifié.
Notes
L’en-tête setupapi.h définit SetupGetSourceFileSize en tant qu’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. La combinaison 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.
Configuration requise
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | setupapi.h |
| Bibliothèque | Setupapi.lib |
| DLL | Setupapi.dll |