SetupGetSourceFileSizeA, fonction (setupapi.h)

Article
11/20/2024

[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 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 sera utilisée.

[in] InfContext

Pointeur facultatif vers un contexte pour une ligne d’une copier des fichiers section pour laquelle la taille doit être récupérée. Si InfContext est NULL, le paramètre FileName est utilisé.

[in] FileName

Pointeur facultatif vers une chaîne null-terminated contenant le nom de fichier (aucun chemin) pour lequel retourner la taille. Si ce paramètre est NULL ainsi que InfContext, le paramètre section est utilisé.

[in] Section

Pointeur facultatif vers une chaînenull -terminated 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 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 pas, sauf si RoundingFactor est spécifié.

Valeur de retour

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’erreur étendues, appelez GetLastError.

Remarques

Un seul des paramètres facultatifs, InfContext, FileNameet Section, doivent être spécifiés.

Note

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

Voir aussi

Functions

Vue d’ensemble

SetupGetSourceFileLocation

Partager via