Funzione SetupGetInfFileListW (setupapi.h)

Articolo
08/26/2023

[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 delle applicazioni. SetupAPI continua a essere usato per l'installazione dei driver di dispositivo.

La funzione SetupGetInfFileList restituisce un elenco di file INF che si trovano in una directory specificata dal chiamante in un buffer fornito dalla chiamata.

Sintassi

WINSETUPAPI BOOL SetupGetInfFileListW(
  [in]      PCWSTR DirectoryPath,
  [in]      DWORD  InfStyle,
  [in, out] PWSTR  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 utilizzata 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 INF di Windows.

[in, out] ReturnBuffer

Se non è NULL, 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 sono con terminazione 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 sola 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 dovuti a dimensioni del buffer insufficienti. I nomi file non includono il percorso. Vedere la sezione relativa alle osservazioni.

[in] ReturnBufferSize

Dimensioni del buffer a cui punta il parametro ReturnBuffer , in caratteri. Ciò include il carattere di terminazione 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. Ciò include il carattere di terminazione Null . Se viene specificato ReturnBuffer 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 returnBuffer di NULL e ReturnBufferSize pari a zero, la funzione inserisce le dimensioni del buffer necessarie per contenere i dati specificati nella variabile a cui punta RequiredSize. Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero. In caso contrario, il valore restituito è zero e le informazioni sull'errore estese possono essere ottenute chiamando GetLastError.

Se tramite questa funzione vengono restituiti più stili di file INF, 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

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