Função SetupDiAskForOEMDisk (setupapi.h)
A função SetupDiAskForOEMDisk exibe uma caixa de diálogo que solicita ao usuário o caminho de um disco de instalação do OEM.
Sintaxe
WINSETUPAPI BOOL SetupDiAskForOEMDisk(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData
);
Parâmetros
[in] DeviceInfoSet
Um identificador para um conjunto de informações de dispositivo para o computador local. Esse conjunto contém um elemento de informações do dispositivo que representa o dispositivo que está sendo instalado.
[in, optional] DeviceInfoData
Um ponteiro para uma estrutura SP_DEVINFO_DATA que especifica o elemento de informações do dispositivo em DeviceInfoSet. Esse parâmetro é opcional e pode ser NULL. Se esse parâmetro for especificado, SetupDiAskForOEMDisk associará o driver ao dispositivo que está sendo instalado. Se esse parâmetro for NULL, SetupDiAskForOEMDisk associará o driver à lista de drivers de classe global para DeviceInfoSet.
Retornar valor
A função retornará TRUE se for bem-sucedida e o campo DriverPath da estrutura SP_DEVINSTALLPARAMS for atualizado para refletir o novo caminho. Se o usuário cancelar a caixa de diálogo, a função retornará FALSE e uma chamada para GetLastError retornará ERROR_CANCELLED.
Comentários
SetupDiAskForOEMDisk permite que o usuário procure unidades locais e de rede para arquivos de instalação do OEM. No entanto, SetupDiAskForOEMDisk foi projetado principalmente para obter o caminho de um driver OEM em um computador local antes de selecionar e instalar o driver para um dispositivo nesse computador.
Embora essa função não falhe se as informações do dispositivo forem definidas se for para um computador remoto, o resultado será de uso limitado porque o conjunto de informações do dispositivo não pode ser usado posteriormente com solicitações de instalação DIF_Xxx ou funções SetupDiXxx que não dão suporte a operações em um computador remoto.
Em particular, o conjunto de informações do dispositivo não pode ser usado como entrada com uma solicitação de instalação DIF_SELECTDEVICE para selecionar um driver para um dispositivo, seguido por uma solicitação de instalação DIF_INSTALLDEVICE para instalar um dispositivo em um computador remoto.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Microsoft Windows 2000 e versões posteriores do Windows. |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | setupapi.h (inclua Setupapi.h) |
| Biblioteca | Setupapi.lib |
| DLL | Setupapi.dll |