Funzione SetupGetLineByIndexW (setupapi.h)
[Questa funzione è disponibile per l'uso nei sistemi operativi indicati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive. SetupAPI non deve più essere usata 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 SetupGetLineByIndexW(
[in] HINF InfHandle,
[in] PCWSTR 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 ottenere informazioni estese sull'errore, chiamare GetLastError.
Osservazioni
Se InfHandle fa riferimento a più file INF che sono stati aggiunti insieme usando SetupOpenAppendInfFile, questa funzione cerca 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows XP [solo app desktop] |
| server minimo supportato | Windows Server 2003 [solo app desktop] |
| piattaforma di destinazione | Finestre |
| 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) |