Funzione SetupGetLineByIndexA (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 SetupGetLineByIndex individua una riga in base al valore di indice nella sezione specificata nel file INF.
Sintassi
WINSETUPAPI BOOL SetupGetLineByIndexA(
[in] HINF InfHandle,
[in] PCSTR Section,
[in] DWORD Index,
[in, out] PINFCONTEXT Context
);
Parametri
[in] InfHandle
Handle per il file INF.
[in] Section
Puntatore a una stringa con terminazione Null che specifica la sezione del file INF da cercare.
[in] Index
Indice della riga da individuare. Il numero totale di righe in una sezione specifica è disponibile con una chiamata a SetupGetLineCount.
[in, out] Context
Puntatore a una variabile che riceve le informazioni di contesto per la riga trovata.
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
Se InfHandle fa riferimento a più file INF aggiunti insieme tramite SetupOpenAppendInfFile, questa funzione esegue la ricerca nella sezione specificata in tutti i file a cui fa riferimento HINF per individuare la riga indicizzata.
Nota
L'intestazione setupapi.h definisce SetupGetLineByIndex come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
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) |