Funzione SetupGetInfPublishedNameA (setupapi.h)
La funzione SetupGetInfPublishedName recupera il nome file completo (percorso della directory e il nome file) di un file INF nella directory file INF del sistema che corrisponde a un file INF specificato nell'archivio driver o in un file INF specificato nella directory file INF del sistema.
Sintassi
WINSETUPAPI BOOL SetupGetInfPublishedNameA(
[in] PCSTR DriverStoreLocation,
[out] PSTR ReturnBuffer,
[in] DWORD ReturnBufferSize,
[out, optional] PDWORD RequiredSize
);
Parametri
[in] DriverStoreLocation
Puntatore a una stringa con terminazione NULL contenente il nome di file completo (percorso della directory e nome file) di un file INF nell'archivio driver. In alternativa, questo parametro è un puntatore a una stringa con terminazione NULL contenente il nome e, facoltativamente, il percorso completo della directory, di un file INF nella directory file INF del sistema. Per altre informazioni su come specificare il file INF, vedere la sezione Osservazioni seguenti.
[out] ReturnBuffer
Puntatore al buffer in cui SetupGetInfPublishedName restituisce una stringa con terminazione NULL contenente il nome completo del file INF specificato nella directory INF del sistema. La dimensione massima del percorso è MAX_PATH. Questo puntatore può essere impostato su NULL. Per informazioni su come determinare le dimensioni necessarie del buffer restituito, vedere la sezione Note seguenti.
[in] ReturnBufferSize
Dimensioni, in caratteri, del buffer fornito da ReturnBuffer.
[out, optional] RequiredSize
Puntatore a una variabile tipizzata DWORD che riceve le dimensioni, in caratteri, del buffer ReturnBuffer . Questo parametro è facoltativo e può essere impostato su NULL.
Valore restituito
Se SetupGetInfPublishedName ha esito positivo, la funzione restituisce TRUE; in caso contrario, la funzione restituisce FALSE. Per ottenere informazioni sull'errore estese, chiamare GetLastError.
Se le dimensioni, in caratteri, del nome di file completo del file INF richiesto, incluso un terminatore null, è maggiore di ReturnBufferSize, la funzione avrà esito negativo e una chiamata a GetLastError restituirà ERROR_INSUFFICIENT_BUFFER.
Commenti
Per determinare le dimensioni del buffer restituito necessario per contenere il nome completo del file INF specificato nella directory INF del sistema, chiamare SetupGetInfPublishedName e impostare ReturnBuffer su NULL, ReturnBufferSize su zero e specificare RequiredSize. SetupGetInfPublishedName restituirà le dimensioni del buffer necessarie in RequiredSize.
Quando l'installazione del dispositivo preinstalla un pacchetto driver nell'archivio driver, crea due copie del file INF del pacchetto driver. L'installazione del dispositivo aggiunge una copia alla directory INF di sistema e assegna tale copia del file INF a un nome file pubblicato univoco del modulo OEMnnn.inf. L'installazione del dispositivo aggiunge una seconda copia del file INF all'archivio driver e assegna la copia del nome del file INF originale.
SetupGetInfPublishedName restituisce il nome di file completo del file INF nella directory file INF di sistema corrispondente al file INF, se presente, fornito da DriverStoreLocation. DriverStoreLocation deve specificare il nome di file completo di un file INF nell'archivio driver o deve specificare il nome del file e, facoltativamente, il percorso della directory, di un file INF nella directory INF del sistema. Si supponga, ad esempio, che il file INF per un pacchetto driver sia myinf.inf e che per questo pacchetto driver, l'installazione del dispositivo installa il file INF OEM1.inf nella directory INF del sistema C:\Windows\inf. Si supponga inoltre che l'installazione del dispositivo installi la copia del file INF corrispondente C:\windows\system32\driverstore\filerepository\myinf_12345678\myinf.inf nell'archivio driver. In questo caso, la funzione restituisce C:\Windows\inf\OEM1.inf se DriverStoreLocation fornisce una delle stringhe seguenti: C:\windows\system32\driverstore\filerepository\myinf_12345678\myinf.inf, OEM1.inf o C:\Windows\inf\OEM1.inf.
Chiamare la funzione SetupGetInfDriverStoreLocation per recuperare il nome di file completo di un file INF nell'archivio driver che corrisponde a un file INF specificato nella directory file INF del sistema o un file specificato nell'archivio driver.
Nota
L'intestazione setupapi.h definisce SetupGetInfPublishedName 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 | Disponibile in Windows Vista e versioni successive di Windows. |
| Piattaforma di destinazione | Desktop |
| Intestazione | setupapi.h (includere Setupapi.h) |
| Libreria | Setupapi.lib |