Condividi tramite


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)

Vedi anche

Funzioni

Panoramica

SetupFindNextLine

SetupFindNextMatchLine

SetupGetLineByIndex