Fonction SetupGetSourceFileSizeW (setupapi.h)
[Cette fonction est disponible pour une utilisation 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 l’installation d’applications. Utilisez plutôt Windows Installer pour développer des programmes d’installation d’applications. SetupAPI continue d’être utilisé pour l’installation des 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 SetupGetSourceFileSizeW(
[in] HINF InfHandle,
[in] PINFCONTEXT InfContext,
[in] PCWSTR FileName,
[in] PCWSTR 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 . S’il existe des sections spécifiques à la plateforme pour le système de l’utilisateur (par exemple, SourceDisksNames.x86 et SourceDisksFiles.x86), la section spécifique à la plateforme sera utilisée.
[in] InfContext
Pointeur facultatif vers un contexte pour une ligne d’une section Copier des fichiers dont 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 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 l’arrondi des 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 précisément 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 et un seul des paramètres facultatifs , InfContext, FileName et Section, doivent être spécifiés.
Notes
L’en-tête setupapi.h définit SetupGetSourceFileSize comme un 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.
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 |