SetupDiDestroyDriverInfoList 함수(setupapi.h)
SetupDiDestroyDriverInfoList 함수는 드라이버 목록을 삭제합니다.
구문
WINSETUPAPI BOOL SetupDiDestroyDriverInfoList(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData,
[in] DWORD DriverType
);
매개 변수
[in] DeviceInfoSet
삭제할 드라이버 목록이 포함된 디바이스 정보 집합 에 대한 핸들입니다.
[in, optional] DeviceInfoData
DeviceInfoSet에서 디바이스 정보 요소를 지정하는 SP_DEVINFO_DATA 구조체에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL로 설정할 수 있습니다. 이 매개 변수를 지정하면 SetupDiDestroyDriverInfoList 가 지정된 디바이스에 대한 드라이버 목록을 삭제합니다. 이 매개 변수가 NULL이면 SetupDiDestroyDriverInfoList 는 DeviceInfoSet과 연결된 전역 클래스 드라이버 목록을 삭제합니다.
[in] DriverType
삭제할 드라이버 목록의 형식이며 다음 값 중 하나여야 합니다.
SPDIT_CLASSDRIVER
클래스 드라이버 목록을 삭제합니다. DeviceInfoData가 NULL인 경우 이 드라이버 목록 유형을 지정해야 합니다.
SPDIT_COMPATDRIVER
지정된 디바이스에 대해 호환되는 드라이버 목록을 삭제합니다. 이 드라이버 목록 형식이 지정된 경우 DeviceInfoData를 지정해야 합니다.
반환 값
함수가 성공하면 TRUE 를 반환합니다. 그렇지 않으면 FALSE 를 반환하고 GetLastError를 호출하여 기록된 오류를 검색할 수 있습니다.
설명
현재 선택한 드라이버가 삭제되는 목록의 멤버인 경우 선택 영역이 다시 설정됩니다.
클래스 드라이버 목록이 삭제되는 경우 해당 디바이스 정보 집합 또는 디바이스 정보 요소에 대해 DI_FLAGSEX_DIDINFOLIST 및 DI_DIDCLASS 플래그가 다시 설정됩니다. DI_MULTMFGS 플래그도 다시 설정됩니다.
호환되는 드라이버 목록이 제거되는 경우 해당 디바이스 정보 요소에 대해 DI_FLAGSEX_DIDCOMPATINFO 및 DI_DIDCOMPAT 플래그가 다시 설정됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Microsoft Windows 2000 이상 버전의 Windows에서 사용할 수 있습니다. |
| 대상 플랫폼 | 데스크톱 |
| 머리글 | setupapi.h(Setupapi.h 포함) |
| 라이브러리 | Setupapi.lib |
| DLL | Setupapi.dll |
| API 세트 | ext-ms-win-setupapi-classinstallers-l1-1-2(Windows 10 버전 10.0.14393에 도입됨) |