다음을 통해 공유

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

추가 정보

SetupDiSelectOEMDrv