Função SetupGetIntField (setupapi.h)

Artigo
03/01/2024

[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 SetupGetIntField recupera um valor inteiro do campo especificado de uma linha em um arquivo INF.

Sintaxe

WINSETUPAPI BOOL SetupGetIntField(
  [in]  PINFCONTEXT Context,
  [in]  DWORD       FieldIndex,
  [out] PINT        IntegerValue
);

Parâmetros

[in] Context

Ponteiro para o contexto de uma linha em um arquivo INF.

[in] FieldIndex

O índice baseado em 1 do campo dentro da linha especificada da qual o inteiro deve ser recuperado.

Um FieldIndex de 0 pode ser usado para recuperar uma chave inteira (por exemplo, considere a seguinte linha INF, 431 = 1, 2, 4. O valor 431 seria colocado na variável apontada por IntegerValue se SetupGetIntField fosse chamado com um FieldIndex de 0).

[out] IntegerValue

Ponteiro para uma variável que recebe o inteiro. Se o campo não for um inteiro, a função falhará e uma chamada para GetLastError retornará ERROR_INVALID_DATA.

Retornar valor

Se a função for bem-sucedida, o valor retornado será um valor diferente de zero.

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

Comentários

O campo inteiro pode começar com um sinal positivo (+) ou negativo (-). Ele será interpretado como um número decimal, a menos que prefixado no arquivo com 0x ou 0X, nesse caso ele é hexadecimal.

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)