Función SetupEnumInfSectionsW (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 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 la 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 de terminación NULL.

[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 la sección, incluida la terminación carácter de NULL.

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.

Observaciones

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 al incrementar el índice hasta que la función devuelva FALSE y GetLastError devuelve 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 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
conjunto de API de	ext-ms-win-setupapi-inf-l1-1-1 (introducido en Windows 10, versión 10.0.14393)