Función SetupDiAskForOEMDisk (setupapi.h)

La función SetupDiAskForOEMDisk muestra un cuadro de diálogo que pide al usuario la ruta de acceso de un disco de instalación oem.

Sintaxis

WINSETUPAPI BOOL SetupDiAskForOEMDisk(
  [in]           HDEVINFO         DeviceInfoSet,
  [in, optional] PSP_DEVINFO_DATA DeviceInfoData
);

Parámetros

[in] DeviceInfoSet

Identificador de un conjunto de información de dispositivo para el equipo local. Este conjunto contiene un elemento de información del dispositivo que representa el dispositivo que se está instalando.

[in, optional] DeviceInfoData

Puntero a una estructura de SP_DEVINFO_DATA que especifica el elemento de información del dispositivo en DeviceInfoSet. Este parámetro es opcional y puede ser NULL. Si se especifica este parámetro, SetupDiAskForOEMDisk asocia el controlador con el dispositivo que se está instalando. Si este parámetro es NULL, SetupDiAskForOEMDisk asocia el controlador a la lista global de controladores de clase para DeviceInfoSet.

Valor devuelto

La función devuelve TRUE si se realiza correctamente y el campo DriverPath de la estructura SP_DEVINSTALLPARAMS se actualiza para reflejar la nueva ruta de acceso. Si el usuario cancela el cuadro de diálogo, la función devuelve FALSE y una llamada a GetLastError devuelve ERROR_CANCELLED.

Comentarios

SetupDiAskForOEMDisk permite al usuario examinar las unidades de red y locales de los archivos de instalación de OEM. Sin embargo, SetupDiAskForOEMDisk está diseñado principalmente para obtener la ruta de acceso de un controlador OEM en un equipo local antes de seleccionar e instalar el controlador para un dispositivo en ese equipo.

Aunque esta función no producirá un error si la información del dispositivo establecida si se establece para un equipo remoto, el resultado es de uso limitado porque el conjunto de información del dispositivo no se puede usar posteriormente con las solicitudes de instalación DIF_Xxx o las funciones SetupDiXxx que no admiten operaciones en un equipo remoto.

En concreto, el conjunto de información del dispositivo no se puede usar como entrada con una solicitud de instalación de DIF_SELECTDEVICE para seleccionar un controlador para un dispositivo, seguido de una solicitud de instalación de DIF_INSTALLDEVICE para instalar un dispositivo en un equipo remoto.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Microsoft Windows 2000 y versiones posteriores de Windows.
Plataforma de destino	Escritorio
Encabezado	setupapi.h (incluya Setupapi.h)
Library	Setupapi.lib
Archivo DLL	Setupapi.dll

Consulte también

SetupDiSelectOEMDrv