Funzione SetupFindFirstLineA (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 di applicazioni. SetupAPI continua a essere usato per l'installazione dei driver di dispositivo.
La funzione SetupFindFirstLine individua una riga nella sezione specificata di un file INF. Se il parametro Key è NULL, SetupFindFirstLine restituisce la prima riga della sezione.
Sintassi
WINSETUPAPI BOOL SetupFindFirstLineA(
[in] HINF InfHandle,
[in] PCSTR Section,
[in] PCSTR Key,
[in, out] PINFCONTEXT Context
);
Parametri
[in] InfHandle
Gestire il file INF per eseguire query.
[in] Section
Puntatore a una stringa con terminazione null specificando la sezione dei file INF da cercare.
[in] Key
Puntatore facoltativo a una stringa con terminazione null specificando la chiave da cercare all'interno della sezione. La stringa con terminazione null non deve superare le dimensioni del buffer di destinazione. Questo parametro può essere NULL. Se Key è NULL, viene restituita la prima riga della sezione.
[in, out] Context
Puntatore a una struttura che riceve le informazioni sul contesto usate internamente dall'handle INF. Le applicazioni non devono sovrascrivere i valori in questa struttura.
Valore restituito
Se la funzione non è riuscita a trovare una riga, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
Se il parametro InfHandle fa riferimento a più file INF aggiunti insieme usando SetupOpenAppendInfFile, la funzione SetupFindFirstLine esegue ricerche nella sezione specificata in tutti i file a cui fa riferimento il hinF specificato.
Nota
L'intestazione setupapi.h definisce SetupFindFirstLine come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
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-0 (introdotta in Windows 8) |