Função SetupGetIntField (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 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) |