Funzione SetupGetInfInformationW (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 SetUpGetInfInformation
Sintassi
WINSETUPAPI BOOL SetupGetInfInformationW(
[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 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 caso affermativo, 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 nei percorsi predefiniti il file INF specificato per InfSpec, che si presuppone che sia solo un nome file. I percorsi predefiniti sono %windir%\inf, seguiti da %windir%\system32.
INFINFO_REVERSE_DEFAULT_SEARCH
Come INFINFO_DEFAULT_SEARCH, ad eccezione delle posizioni predefinite, vengono eseguite ricerche in ordine inverso.
INFINFO_INF_PATH_LIST_SEARCH
Cercare il valore INF in ognuna delle directory elencate nella voce valore DevicePath nella sezione 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 a causa di 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 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 è 0 (zero). Per ottenere informazioni estese 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.
Osservazioni
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 estese sull'errore 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 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 |