Condividi tramite


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)

Vedi anche

Funzioni

Panoramica

SetupFindFirstLine

SetupFindNextLine

SetupGetLineByIndex