Funzione SetupGetIntField (setupapi.h)
[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) |