SetupDiAskForOEMDisk-Funktion (setupapi.h)

Die SetupDiAskForOEMDisk-Funktion zeigt ein Dialogfeld an, das den Benutzer nach dem Pfad eines OEM-Installationsdatenträgers fragt.

Syntax

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

Parameter

[in] DeviceInfoSet

Ein Handle zu einem Geräteinformationssatz für den lokalen Computer. Dieser Satz enthält ein Geräteinformationselement, das das gerät darstellt, das installiert wird.

[in, optional] DeviceInfoData

Ein Zeiger auf eine SP_DEVINFO_DATA-Struktur , die das Geräteinformationselement in DeviceInfoSet angibt. Dieser Parameter ist optional und kann NULL sein. Wenn dieser Parameter angegeben ist, ordnet SetupDiAskForOEMDisk den Treiber dem installierten Gerät zu. Wenn dieser Parameter NULL ist, ordnet SetupDiAskForOEMDisk den Treiber der globalen Klassentreiberliste für DeviceInfoSet zu.

Rückgabewert

Die Funktion gibt TRUE zurück, wenn sie erfolgreich ist und das DriverPath-Feld der SP_DEVINSTALLPARAMS-Struktur aktualisiert wird, um den neuen Pfad widerzuspiegeln. Wenn der Benutzer das Dialogfeld abbricht, gibt die Funktion FALSE zurück, und ein Aufruf von GetLastError gibt ERROR_CANCELLED zurück.

Hinweise

SetupDiAskForOEMDisk ermöglicht es dem Benutzer, lokale Laufwerke und Netzwerklaufwerke nach OEM-Installationsdateien zu durchsuchen. SetupDiAskForOEMDisk ist jedoch in erster Linie dafür konzipiert, den Pfad eines OEM-Treibers auf einem lokalen Computer abzurufen, bevor der Treiber für ein Gerät auf diesem Computer ausgewählt und installiert wird.

Obwohl diese Funktion nicht fehlschlägt, wenn die Geräteinformationen für einen Remotecomputer festgelegt werden, ist das Ergebnis von eingeschränkter Verwendung, da der Geräteinformationssatz anschließend nicht mit DIF_Xxx-Installationsanforderungen oder SetupDiXxx-Funktionen verwendet werden kann, die keine Vorgänge auf einem Remotecomputer unterstützen.

Insbesondere kann der Geräteinformationssatz nicht als Eingabe mit einer DIF_SELECTDEVICE Installationsanforderung verwendet werden, um einen Treiber für ein Gerät auszuwählen, gefolgt von einer DIF_INSTALLDEVICE Installationsanforderung zum Installieren eines Geräts auf einem Remotecomputer.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows.
Zielplattform	Desktop
Kopfzeile	setupapi.h (einschließlich Setupapi.h)
Bibliothek	Setupapi.lib
DLL	Setupapi.dll

Weitere Informationen

SetupDiSelectOEMDrv