Funzione SetupDiAskForOEMDisk (setupapi.h)
La funzione SetupDiAskForOEMDisk visualizza una finestra di dialogo che chiede all'utente il percorso di un disco di installazione OEM.
Sintassi
WINSETUPAPI BOOL SetupDiAskForOEMDisk(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData
);
Parametri
[in] DeviceInfoSet
Handle per un set di informazioni sul dispositivo per il computer locale. Questo set contiene un elemento informazioni sul dispositivo che rappresenta il dispositivo in fase di installazione.
[in, optional] DeviceInfoData
Puntatore a una struttura SP_DEVINFO_DATA che specifica l'elemento informazioni sul dispositivo in DeviceInfoSet. Questo parametro è facoltativo e può essere NULL. Se questo parametro viene specificato, SetupDiAskForOEMDisk associa il driver al dispositivo in fase di installazione. Se questo parametro è NULL, SetupDiAskForOEMDisk associa il driver all'elenco di driver di classe globale per DeviceInfoSet.
Valore restituito
La funzione restituisce TRUE se ha esito positivo e il campo DriverPath della struttura SP_DEVINSTALLPARAMS viene aggiornato in modo da riflettere il nuovo percorso. Se l'utente annulla la finestra di dialogo, la funzione restituisce FALSE e una chiamata a GetLastError restituisce ERROR_CANCELLED.
Commenti
SetupDiAskForOEMDisk consente all'utente di esplorare le unità locali e di rete per i file di installazione OEM. Tuttavia , SetupDiAskForOEMDisk è progettato principalmente per ottenere il percorso di un driver OEM in un computer locale prima di selezionare e installare il driver per un dispositivo in tale computer.
Sebbene questa funzione non abbia esito negativo se le informazioni sul dispositivo impostate se per un computer remoto, il risultato è limitato perché il set di informazioni sul dispositivo non può essere usato successivamente con le richieste di installazione DIF_Xxx o le funzioni SetupDiXxx che non supportano le operazioni in un computer remoto.
In particolare, il set di informazioni sul dispositivo non può essere usato come input con una richiesta di installazione DIF_SELECTDEVICE per selezionare un driver per un dispositivo, seguito da una richiesta di installazione DIF_INSTALLDEVICE per installare un dispositivo in un computer remoto.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Microsoft Windows 2000 e versioni successive di Windows. |
| Piattaforma di destinazione | Desktop |
| Intestazione | setupapi.h (include Setupapi.h) |
| Libreria | Setupapi.lib |
| DLL | Setupapi.dll |