Función SetupGetSourceFileSizeA (setupapi.h)
[Esta función está disponible para su uso en los sistemas operativos indicados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores. SetupAPI ya no debe usarse para instalar aplicaciones. En su lugar, use Windows Installer para desarrollar instaladores de aplicaciones. SetupAPI sigue usándose para instalar controladores de dispositivo.]
La función SetupGetSourceFileSize lee el tamaño sin comprimir de un archivo de origen enumerado en un archivo INF.
Sintaxis
WINSETUPAPI BOOL SetupGetSourceFileSizeA(
[in] HINF InfHandle,
[in] PINFCONTEXT InfContext,
[in] PCSTR FileName,
[in] PCSTR Section,
[in, out] PDWORD FileSize,
[in] UINT RoundingFactor
);
Parámetros
[in] InfHandle
Controla el archivo INF cargado que contiene las secciones SourceDisksName sNames y SourceDisksFiles. Si existen secciones específicas de la plataforma para el sistema del usuario (por ejemplo, sourceDisksNames.x86 y SourceDisksFiles.x86), se usará la sección específica de la plataforma.
[in] InfContext
Puntero opcional a un contexto de una línea en una sección Copiar archivos para la que se va a recuperar el tamaño. Si InfContext es null, se usa el parámetro FileName.
[in] FileName
Puntero opcional a un cadena terminada en nullque contiene el nombre de archivo (sin ruta de acceso) para el que se va a devolver el tamaño. Si este parámetro es
[in] Section
Puntero opcional a un cadenaterminada en null que contiene el nombre de una sección Copiar archivos. Si se especifica este parámetro, se calcula el tamaño total de todos los archivos enumerados en la sección.
[in, out] FileSize
Puntero a una variable que recibe el tamaño, en bytes, de los archivos especificados.
[in] RoundingFactor
Valor opcional para redondear tamaños de archivo. Todos los tamaños de archivo se redondean hasta un múltiplo de este número antes de agregarse al tamaño total. El redondeo es útil para determinaciones más exactas del espacio que ocupará un archivo en un volumen determinado, ya que permite que el autor de la llamada tenga tamaños de archivo redondeados hasta un múltiplo del tamaño del clúster. El redondeo no se produce a menos que se especifique RoundingFactor.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es un valor distinto de cero.
Si se produce un error en la función, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.
Observaciones
Uno y solo uno de los parámetros opcionales, InfContext, FileNamey Section, deben especificarse.
Nota
El encabezado setupapi.h define SetupGetSourceFileSize como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows XP [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows Server 2003 [solo aplicaciones de escritorio] |
| de la plataforma de destino de |
Windows |
| encabezado de |
setupapi.h |
| biblioteca de |
Setupapi.lib |
| DLL de |
Setupapi.dll |
Consulte también
funciones de