Funzione SetupFindFirstLineA (setupapi.h)

Articolo
11/20/2024

[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 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 una query.

[in] Section

Puntatore a un nullstringa con terminazione che specifica la sezione dei file INF in cui eseguire la ricerca.

[in] Key

Puntatore facoltativo a un nullstringa con terminazione che specifica la chiave da cercare all'interno della sezione. Il nullstringa con terminazione 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 riesce a trovare una riga, il valore restituito è zero. Per ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

Se il parametro InfHandle fa riferimento a più file INF aggiunti insieme usando SetupOpenAppendInfFile, la funzione SetupFindFirstLine cerca 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 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-0 (introdotto in Windows 8)

Vedere anche

Funzioni

panoramica

SetupFindNextLine

SetupFindNextMatchLine

SetupGetLineByIndex

Condividi tramite