Condividi tramite


Funzione SetupGetInfFileListW (setupapi.h)

[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 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 un nullstringa con terminazione contenente il percorso della directory in cui eseguire la ricerca. Se questo valore è NULL, viene usata la directory \inf %windir%.

[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

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 null-terminate, con un Null aggiuntivo alla fine dell'elenco. Il nullstringa con terminazione 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 file non includono il percorso. Vedere la sezione Osservazioni.

[in] ReturnBufferSize

Dimensioni del buffer a cui punta il parametro ReturnBuffer, in caratteri. Ciò include il carattere di terminazione null . Se non si specifica ReturnBuffer, 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 non riesce 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 ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

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 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 è possibile ottenere informazioni estese sull'errore chiamando GetLastError.

Se da questa funzione vengono restituiti più stili di file INF, lo stile di un particolare 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 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

Vedere anche

Funzioni

panoramica

SetupGetInfInformation