Funzione SetupFindNextMatchLineA (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 SetupFindNextMatchLine restituisce il percorso della riga successiva in un file INF relativo a ContextIn.Line corrispondente a una chiave specificata.
Sintassi
WINSETUPAPI BOOL SetupFindNextMatchLineA(
[in] PINFCONTEXT ContextIn,
[in] PCSTR Key,
[in, out] PINFCONTEXT ContextOut
);
Parametri
[in] ContextIn
Puntatore a un contesto di file INF, come recuperato da una chiamata alla funzione SetupFindFirstLine .
[in] Key
Se questo parametro facoltativo viene specificato, fornisce una chiave da corrispondere. Questo parametro deve essere una stringa con terminazione null. Questo parametro può essere Null. Se key non è specificato, la funzione SetupFindNextMatchLine equivale alla funzione SetupFindNextLine .
[in, out] ContextOut
Puntatore a una variabile in cui questa funzione restituisce il contesto della riga trovata. ContextOut può puntare a ContextIn se il chiamante desidera.
Valore restituito
La funzione restituisce un valore diverso da zero se trova una riga corrispondente. In caso contrario, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
Se ContextIn.Inf fa riferimento a più file INF aggiunti insieme usando SetupOpenAppendInfFile, la funzione SetupFindNextMatchLine cerca nella sezione specificata in tutti i file a cui fa riferimento hinF per individuare la riga corrispondente successiva.
Nota
L'intestazione setupapi.h definisce SetupFindNextMatchLine 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) |