Funzione SetupGetInfFileListA (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 SetupGetInfFileList restituisce un elenco di file INF presenti in una directory specificata dal chiamante a un buffer fornito dalla chiamata.
Sintassi
WINSETUPAPI BOOL SetupGetInfFileListA(
[in] PCSTR DirectoryPath,
[in] DWORD InfStyle,
[in, out] PSTR ReturnBuffer,
[in] DWORD ReturnBufferSize,
[in, out] PDWORD RequiredSize
);
Parametri
[in] DirectoryPath
Puntatore facoltativo a una stringa con terminazione null contenente il percorso della directory in cui eseguire la ricerca. Se questo valore è NULL, viene usata la directory %windir%\inf.
[in] InfStyle
Tipo di file INF da cercare. Può essere una combinazione dei flag seguenti.
INF_STYLE_OLDNT
Formato di file INF legacy.
INF_STYLE_WIN4
Formato di file WINDOWS INF.
[in, out] ReturnBuffer
In caso contrario, punta a un buffer in cui questa funzione restituisce l'elenco di tutti i file INF degli stili desiderati trovati nella sottodirectory specificata. I nomi di file vengono terminati con valori Null, con un valore Null aggiuntivo alla fine dell'elenco. La stringa con terminazione null non deve superare le dimensioni del buffer di destinazione. È possibile chiamare la funzione una volta per ottenere le dimensioni del buffer necessarie, allocare la memoria necessaria e quindi chiamare la funzione una seconda volta per recuperare i dati. Usando questa tecnica, è possibile evitare errori a causa di dimensioni del buffer insufficienti. I nomi dei file non includono il percorso. Vedere la sezione relativa alle osservazioni.
[in] ReturnBufferSize
Dimensioni del buffer a cui punta il parametro ReturnBuffer , in caratteri. Include il terminatore Null . Se ReturnBuffer non è specificato, ReturnBufferSize viene ignorato.
[in, out] RequiredSize
Se non NULL, punta a una variabile in cui questa funzione restituisce le dimensioni necessarie per il buffer a cui punta il parametro ReturnBuffer , in caratteri. Include il terminatore Null . Se ReturnBuffer è specificato e le dimensioni necessarie sono maggiori di ReturnBufferSize, la funzione ha esito negativo e una chiamata a GetLastError restituisce ERROR_INSUFFICIENT_BUFFER.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
Se questa funzione viene chiamata con un ReturnBuffer di NULL e un ReturnBufferSize pari a zero, la funzione inserisce le dimensioni del buffer necessarie per contenere i dati specificati nella variabile puntata a RequiredSize. Se la funzione ha esito positivo in questo caso, il valore restituito è un valore diverso da zero. In caso contrario, il valore restituito è zero e le informazioni di errore estese possono essere ottenute chiamando GetLastError.
Se più stili di file INF vengono restituiti da questa funzione, lo stile di un determinato file INF può essere determinato chiamando la funzione SetupGetInfInformation
Nota
L'intestazione setupapi.h definisce SetupGetInfFileList 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 |