Funzione SetupQueryInfFileInformationA (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 SetupQueryInfFileInformation restituisce un nome file INF da una struttura SP_INF_INFORMATION a un buffer.
Sintassi
WINSETUPAPI BOOL SetupQueryInfFileInformationA(
[in] PSP_INF_INFORMATION InfInformation,
[in] UINT InfIndex,
[in, out] PSTR ReturnBuffer,
[in] DWORD ReturnBufferSize,
[in, out] PDWORD RequiredSize
);
Parametri
[in] InfInformation
Puntatore a una struttura SP_INF_INFORMATION restituita da una chiamata alla funzione SetupGetInfInformation .
[in] InfIndex
Indice del nome file INF costitutivo da recuperare. Questo indice può trovarsi nell'intervallo [0, InfInformation.InfCount). Ciò significa che i valori zero attraverso, ma non inclusi, InfInformation.InfCount sono validi.
[in, out] ReturnBuffer
In caso contrario, ReturnBuffer è un puntatore a un buffer in cui questa funzione restituisce il nome del file INF completo. È consigliabile usare una stringa con terminazione Null. 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. Vedere la sezione relativa alle osservazioni. Usando questa tecnica, è possibile evitare errori a causa di dimensioni del buffer insufficienti. Questo parametro può essere NULL.
[in] ReturnBufferSize
Dimensioni del buffer a cui punta il parametro ReturnBuffer , in caratteri. Include il terminatore Null .
[in, out] RequiredSize
In caso contrario, puntatore a una variabile che riceve le dimensioni necessarie per il buffer ReturnBuffer , in caratteri. Include il terminatore Null . Se ReturnBuffer viene specificato e le dimensioni effettive 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.
Nota
L'intestazione setupapi.h definisce SetupQueryInfFileInformation 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 |