SetupDiAskForOEMDisk 함수(setupapi.h)
SetupDiAskForOEMDisk 함수는 사용자에게 OEM 설치 디스크의 경로를 요청하는 대화 상자를 표시합니다.
구문
WINSETUPAPI BOOL SetupDiAskForOEMDisk(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData
);
매개 변수
[in] DeviceInfoSet
로컬 컴퓨터에 대해 설정된 디바이스 정보에 대한 핸들입니다. 이 집합에는 설치 중인 디바이스를 나타내는 디바이스 정보 요소가 포함되어 있습니다.
[in, optional] DeviceInfoData
DeviceInfoSet에서 디바이스 정보 요소를 지정하는 SP_DEVINFO_DATA 구조체에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다. 이 매개 변수를 지정하면 SetupDiAskForOEMDisk 는 드라이버를 설치 중인 디바이스와 연결합니다. 이 매개 변수가 NULL인 경우 SetupDiAskForOEMDisk 는 DeviceInfoSet에 대한 전역 클래스 드라이버 목록과 드라이버를 연결합니다.
반환 값
함수는 성공하면 TRUE 를 반환하고 SP_DEVINSTALLPARAMS 구조체의 DriverPath 필드가 새 경로를 반영하도록 업데이트됩니다. 사용자가 대화 상자를 취소하면 함수는 FALSE 를 반환하고 GetLastError 호출은 ERROR_CANCELLED 반환합니다.
설명
SetupDiAskForOEMDisk 를 사용하면 사용자가 OEM 설치 파일에 대한 로컬 및 네트워크 드라이브를 검색할 수 있습니다. 그러나 SetupDiAskForOEMDisk 는 주로 해당 컴퓨터에 디바이스에 대한 드라이버를 선택하고 설치하기 전에 로컬 컴퓨터에서 OEM 드라이버의 경로를 가져오도록 설계되었습니다.
원격 컴퓨터의 경우 디바이스 정보가 설정된 경우 이 함수는 실패하지 않지만, 이후 디바이스 정보 집합을 원격 컴퓨터에서 작업을 지원하지 않는 DIF_Xxx 설치 요청 또는 SetupDiXxx 함수와 함께 사용할 수 없으므로 그 결과는 제한적입니다.
특히 디바이스 정보 집합은 디바이스에 대한 드라이버를 선택하는 DIF_SELECTDEVICE 설치 요청과 함께 입력으로 사용할 수 없으며 원격 컴퓨터에 디바이스를 설치하기 위한 DIF_INSTALLDEVICE 설치 요청이 뒤따릅니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Microsoft Windows 2000 이상 버전의 Windows에서 사용할 수 있습니다. |
| 대상 플랫폼 | 데스크톱 |
| 머리글 | setupapi.h(Setupapi.h 포함) |
| 라이브러리 | Setupapi.lib |
| DLL | Setupapi.dll |