Funzione SetupGetInfInformationA (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 delle applicazioni. SetupAPI continua a essere usato per l'installazione dei driver di dispositivo.
La funzione SetUpGetInfInformation restituisce la struttura SP_INF_INFORMATION per il file INF specificato in un buffer.
Sintassi
WINSETUPAPI BOOL SetupGetInfInformationA(
[in] LPCVOID InfSpec,
[in] DWORD SearchControl,
[in, out] PSP_INF_INFORMATION ReturnBuffer,
[in] DWORD ReturnBufferSize,
[in, out] PDWORD RequiredSize
);
Parametri
[in] InfSpec
Gestire o un nome di file per un file INF, a seconda del valore di SearchControl.
[in] SearchControl
Questo parametro può essere una delle costanti seguenti.
INFINFO_INF_SPEC_IS_HINF
InfSpec è un handle INF. Un singolo handle INF può fare riferimento a più file INF se sono stati caricati insieme. In tal caso, la struttura restituita da questa funzione contiene più set di informazioni.
INFINFO_INF_NAME_IS_ABSOLUTE
La stringa specificata per InfSpec è un percorso completo. Non viene eseguita alcuna ulteriore elaborazione in InfSpec.
INFINFO_DEFAULT_SEARCH
Cercare i percorsi predefiniti per il file INF specificato per InfSpec, che si presuppone che sia solo un nome file. Le posizioni predefinite sono %windir%\inf, seguite da %windir%\system32.
INFINFO_REVERSE_DEFAULT_SEARCH
Uguale a INFINFO_DEFAULT_SEARCH, ad eccezione delle posizioni predefinite, viene eseguita la ricerca in ordine inverso.
INFINFO_INF_PATH_LIST_SEARCH
Cercare l'INF in ognuna delle directory elencate nella voce del valore DevicePath sotto la seguente:HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion
[in, out] ReturnBuffer
Se non è NULL, punta a un buffer in cui questa funzione restituisce la struttura SP_INF_INFORMATION .
È 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 dovuti a dimensioni del buffer insufficienti. Per altre informazioni, vedere la sezione Osservazioni di questo argomento.
[in] ReturnBufferSize
Dimensioni di ReturnBuffer, in byte.
[in, out] RequiredSize
Se non è NULL, punta a una variabile in cui questa funzione restituisce le dimensioni richieste, in byte, per il buffer a cui punta ReturnBuffer.
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 è 0 (zero). Per informazioni dettagliate sull'errore, chiamare GetLastError.
Se non è possibile trovare il file INF, la funzione restituisce FALSE e una chiamata successiva a GetLastError restituisce ERROR_FILE_NOT_FOUND.
Commenti
Se questa funzione viene chiamata con returnBuffer di NULL e ReturnBufferSize pari a 0 (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 è 0 (zero) e le informazioni sugli errori estese possono essere ottenute chiamando GetLastError.
Nota
L'intestazione setupapi.h definisce SetupGetInfInformation 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 |