Funzione SetupGetIntField (setupapi.h)

Articolo
03/13/2024

[Questa funzione è disponibile per l'uso nei sistemi operativi indicati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. SetupAPI non deve più essere usato per l'installazione di applicazioni. Usare invece Windows Installer per lo sviluppo di programmi di installazione delle applicazioni. SetupAPI continua a essere usato per l'installazione dei driver di dispositivo.

La funzione SetupGetIntField recupera un valore intero dal campo specificato di una riga in un file INF.

Sintassi

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

Parametri

[in] Context

Puntatore al contesto per una riga in un file INF.

[in] FieldIndex

Indice in base 1 del campo all'interno della riga specificata da cui recuperare l'intero.

È possibile usare FieldIndex pari a 0 per recuperare una chiave integer. Si consideri ad esempio la riga INF seguente, 431 = 1, 2, 4. Il valore 431 viene inserito nella variabile a cui punta IntegerValue se SetupGetIntField è stato chiamato con fieldIndex pari a 0.

[out] IntegerValue

Puntatore a una variabile che riceve l'intero. Se il campo non è un numero intero, la funzione ha esito negativo e una chiamata a GetLastError restituisce ERROR_INVALID_DATA.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Il campo integer può iniziare con un segno positivo (+) o negativo (-). Verrà interpretato come numero decimale, a meno che non sia preceduto da 0x o 0X, nel qual caso è esadecimale.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	setupapi.h
Libreria	Setupapi.lib
DLL	Setupapi.dll
Set di API	ext-ms-win-setupapi-inf-l1-1-1 (introdotto in Windows 10, versione 10.0.14393)