Função SetupEnumInfSectionsA (setupapi.h)

[Essa função está disponível para uso nos sistemas operacionais indicados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. SetupAPI não deve mais ser usado para instalar aplicativos. Em vez disso, use o Windows Installer para desenvolver instaladores de aplicativos. SetupAPI continua a ser usado para instalar drivers de dispositivo.]

A função SetupEnumInfSections recupera nomes de seção de um arquivo INF.

Sintaxe

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

Parâmetros

[in] InfHandle

Manipule para o arquivo INF que deve ser consultado.

[in] Index

O índice baseado em zero do nome da seção a ser recuperado. Esse índice pode não corresponder à ordem das seções, pois elas aparecem no arquivo INF.

[out, optional] Buffer

Ponteiro para um buffer que recebe o nome da seção. Você pode chamar a função uma vez para obter o tamanho do buffer necessário, alocar a memória necessária e, em seguida, chamar a função uma segunda vez para recuperar o nome. Usando essa técnica, você pode evitar erros causados por um tamanho de buffer insuficiente. Esse parâmetro é opcional. Para obter mais informações, consulte a seção Comentários.

[in] Size

Tamanho do buffer apontado por ReturnBuffer em caracteres. Esse número inclui o caractere NULL de terminação.

[out, optional] SizeNeeded

Ponteiro para um local que recebe o tamanho necessário do buffer apontado por ReturnBuffer. O tamanho é especificado como o número de caracteres necessários para armazenar o nome da seção, incluindo o caractere NULL de terminação.

Retornar valor

Se a função for bem-sucedida, o valor retornado será TRUE.

Se a função falhar, o valor retornado será FALSE. Para obter informações de erro estendidas, chame GetLastError.

GetLastError retornará ERROR_NO_MORE_ITEMS se o valor de EnumerationIndex for maior ou igual ao número de nomes de seções no arquivo INF.

Comentários

Essa função pode enumerar todos os nomes de seção exclusivos no arquivo INF. Se um nome de seção aparecer mais de uma vez em um arquivo INF, a função retornará o nome apenas uma vez usando um único índice de enumeração. Para retornar todos os nomes de seção no arquivo INF, chame a função começando com um índice de enumeração de zero e faça chamadas repetidas para a função enquanto incrementa o índice até que a função retorne FALSE e GetLastError retorne ERROR_NO_MORE_ITEMS. Seu aplicativo não deve depender dos nomes de seção que estão sendo retornados em qualquer ordem com base no índice de enumeração.

Observação

O cabeçalho setupapi.h define SetupEnumInfSections como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	setupapi.h
Biblioteca	Setupapi.lib
DLL	Setupapi.dll
Conjunto de APIs	ext-ms-win-setupapi-inf-l1-1-1 (introduzido no Windows 10, versão 10.0.14393)