Función SetupGetSourceFileSizeA (setupapi.h)

[Esta función está disponible para su uso en los sistemas operativos indicados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. 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 dispositivos.

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

Identificador del archivo INF cargado que contiene las secciones SourceDisksNames 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 para una línea de 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 una cadena terminada en null que contiene el nombre de archivo (sin ruta de acceso) para el que se va a devolver el tamaño. Si este parámetro es NULL , así como InfContext, se usa el parámetro Section .

[in] Section

Puntero opcional a una cadena terminada 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 al autor de la llamada tener 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 la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Se debe especificar uno y solo uno de los parámetros opcionales InfContext, FileName y Section.

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 Convenciones para prototipos de función.

Requisitos

Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	setupapi.h
Library	Setupapi.lib
Archivo DLL	Setupapi.dll

Vea también

Funciones

Información general

SetupGetSourceFileLocation