Funzione SetupGetInfPublishedNameW (setupapi.h)

La funzione SetupGetInfPublishedName recupera il nome file completo (percorso di directory e nome file) di un file INF nella directory file INF di sistema che corrisponde a un file INF specificato nell'archivio driver o in un file INF specificato nella directory file INF di sistema.

Sintassi

WINSETUPAPI BOOL SetupGetInfPublishedNameW(
  [in]            PCWSTR DriverStoreLocation,
  [out]           PWSTR  ReturnBuffer,
  [in]            DWORD  ReturnBufferSize,
  [out, optional] PDWORD RequiredSize
);

Parametri

[in] DriverStoreLocation

Puntatore a una stringa con terminazione NULL contenente il nome completo del file (percorso di 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 di file INF di sistema. Per altre informazioni su come specificare il file INF, vedere la sezione seguente osservazioni.

[out] ReturnBuffer

Puntatore al buffer in cui SetupGetInfPublishedName restituisce una stringa con terminazione NULL contenente il nome di file completo del file INF specificato nella directory INF di 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 osservazioni seguente.

[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 estese sull'errore, chiamare GetLastError.

Se le dimensioni, in caratteri, del nome file completo del file INF richiesto, incluso un carattere di terminazione Null, sono maggiori di ReturnBufferSize, la funzione avrà esito negativo e una chiamata a GetLastError restituirà ERROR_INSUFFICIENT_BUFFER.

Osservazioni

Per determinare le dimensioni del buffer restituito necessario per contenere il nome completo del file INF specificato nella directory INF di 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 un nome file univoco pubblicato del modulo OEMnnn.inf. L'installazione del dispositivo aggiunge una seconda copia del file INF all'archivio driver e assegna tale copia del nome file INF originale.

SetupGetInfPublishedName restituisce il nome completo del file INF nella directory file INF di sistema che corrisponde al file INF, se presente, fornito da DriverStoreLocation. DriverStoreLocation deve specificare il nome 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 di sistema. Si supponga, ad esempio, che il file INF per un pacchetto driver sia myinf.infe che per questo pacchetto driver, l'installazione del dispositivo installa il file INF OEM1.inf nella directory INF di 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.info C:\Windows\inf\OEM1.inf.

Chiamare la funzione SetupGetInfDriverStoreLocation per recuperare il nome file completo di un file INF nell'archivio driver che corrisponde a un file INF specificato nella directory file INF di sistema o in un file specificato nell'archivio driver.

Fabbisogno

Vedere anche

SetupGetInfDriverStoreLocation