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

Confira também

SetupDiSelectOEMDrv