SetupDiInstallDriverFiles 함수(setupapi.h)
SetupDiInstallDriverFiles 함수는 DIF_INSTALLDEVICEFILES 설치 요청에 대한 기본 처리기입니다.
구문
WINSETUPAPI BOOL SetupDiInstallDriverFiles(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVINFO_DATA DeviceInfoData
);
매개 변수
[in] DeviceInfoSet
파일을 설치할 디바이스를 나타내는 디바이스 정보 요소가 포함된 디바이스 정보 집합 에 대한 핸들입니다. 디바이스 정보 집합에는 원격 요소가 포함되어서는 안됩니다.
[in] DeviceInfoData
DeviceInfoSet에서 디바이스 정보 요소를 지정하는 SP_DEVINFO_DATA 구조체에 대한 포인터입니다.
반환 값
함수가 성공하면 TRUE 를 반환합니다. 그렇지 않으면 FALSE 를 반환하고 GetLastError를 호출하여 기록된 오류를 검색할 수 있습니다.
설명
이 함수를 사용하여 파일을 설치하는 경우 SetupDiInstallDriverFiles 의 호출자는 Administrators 그룹의 구성원이어야 합니다. 그러나 이 함수를 사용하여 파일 큐를 작성하는 경우 Administrators 그룹의 멤버 자격이 필요하지 않습니다.
참고 클래스 설치 관리자만 SetupDiInstallDriverFiles를 호출해야 하며, SetupDiInstallDriverFiles가 기본 드라이버 파일 설치 작업을 완료한 후에 는 클래스 설치 관리자가 드라이버 파일 설치 작업을 수행해야 하는 경우에만 호출해야 합니다. 이러한 경우 클래스 설치 관리자는 설치 관리자가 DIF_INSTALLDEVICEFILES 요청을 처리할 때 SetupDiInstallDriverFiles 를 직접 호출해야 합니다. 기본 처리기를 호출하는 방법에 대한 자세한 내용은 기본 DIF 코드 처리기 호출을 참조하세요.
이 함수가 호출되기 전에 지정된 디바이스 정보 집합 또는 요소에 대해 드라이버를 선택해야 합니다.
이 함수는 선택한 INF 파일에서 CopyFiles, Delfiles 및 Renfiles 항목을 처리합니다.
DeviceInfoSet에는 로컬 컴퓨터의 요소만 포함되어야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Microsoft Windows 2000 이상 버전의 Windows에서 사용할 수 있습니다. |
| 대상 플랫폼 | 데스크톱 |
| 머리글 | setupapi.h(Setupapi.h 포함) |
| 라이브러리 | Setupapi.lib |
| DLL | Setupapi.dll |