Función SetupEnumInfSectionsA (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 SetupEnumInfSections recupera los nombres de sección de un archivo INF.

Sintaxis

WINSETUPAPI BOOL SetupEnumInfSectionsA(
  [in]            HINF InfHandle,
  [in]            UINT Index,
  [out, optional] PSTR 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 realiza 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 en el 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.

Requisitos