Função SetupEnumInfSectionsA (setupapi.h)

Artigo
11/20/2024

[Essa função está disponível para uso nos sistemas operacionais indicados na seção Requisitos. Ele pode estar alterado ou 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 conforme 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 de 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 a terminação caractere NULL caractere.

Valor de retorno

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

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.

Observações

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 zero e faça chamadas repetidas para a função enquanto incrementa o índice até que a função retorne FALSE e GetLastError retorna 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.

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

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

Compartilhar via