Funzione SetupGetInfInformationW (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 SetUpGetInfInformation restituisce la struttura SP_INF_INFORMATION per il file INF specificato in un buffer.

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 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


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