Función SetupEnumInfSectionsW (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 utilizándose para instalar controladores de dispositivo.

La función SetupEnumInfSections recupera los nombres de sección de un archivo INF.

Sintaxis

WINSETUPAPI BOOL SetupEnumInfSectionsW(
  [in]            HINF  InfHandle,
  [in]            UINT  Index,
  [out, optional] PWSTR Buffer,
  [in]            UINT  Size,
  [out, optional] UINT  *SizeNeeded
);

Parámetros

[in] InfHandle

Identificador del archivo INF que se va a consultar.

[in] Index

Índice de base cero del nombre de sección que se va a recuperar. Este índice puede no corresponder al orden de las secciones tal como aparecen en el archivo INF.

[out, optional] Buffer

Puntero a un búfer que recibe el nombre de sección. Puede llamar a la función una vez para obtener el tamaño de búfer necesario, asignar la memoria necesaria y, a continuación, llamar a la función una segunda vez para recuperar el nombre. Con esta técnica, puede evitar errores causados por un tamaño de búfer insuficiente. Este parámetro es opcional. Para obtener más información, vea la sección Comentarios.

[in] Size

Tamaño del búfer al que apunta ReturnBuffer en caracteres. Este número incluye el carácter NULL de terminación.

[out, optional] SizeNeeded

Puntero a una ubicación que recibe el tamaño necesario del búfer al que apunta ReturnBuffer. El tamaño se especifica como el número de caracteres necesarios para almacenar el nombre de sección, incluido el carácter NULL de terminación.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es TRUE.

Si se produce un error en la función, el valor devuelto es FALSE. Para obtener información de error extendida, llame a GetLastError.

GetLastError devuelve ERROR_NO_MORE_ITEMS si el valor de EnumerationIndex es mayor o igual que el número de nombres de secciones del archivo INF.

Comentarios

Esta función puede enumerar todos los nombres de sección únicos del archivo INF. Si un nombre de sección aparece más de una vez en un archivo INF, la función devuelve el nombre solo una vez mediante un único índice de enumeración. Para devolver todos los nombres de sección del archivo INF, llame a la función comenzando por un índice de enumeración de cero y, a continuación, realice llamadas repetidas a la función mientras incrementa el índice hasta que la función devuelva FALSE y GetLastError devuelva ERROR_NO_MORE_ITEMS. La aplicación no debe depender de los nombres de sección que se devuelven en ningún orden en función del índice de enumeración.

Nota

El encabezado setupapi.h define SetupEnumInfSections 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
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
Conjunto de API	ext-ms-win-setupapi-inf-l1-1-1 (introducido en Windows 10, versión 10.0.14393)