SetupDiDeleteDeviceInfo 함수(setupapi.h)
SetupDiDeleteDeviceInfo 함수는 디바이스 정보 집합에서 디바이스 정보 요소를 삭제합니다. 이 함수는 실제 디바이스를 삭제하지 않습니다.
구문
WINSETUPAPI BOOL SetupDiDeleteDeviceInfo(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVINFO_DATA DeviceInfoData
);
매개 변수
[in] DeviceInfoSet
삭제할 디바이스 정보 요소가 포함된 디바이스 정보 집합에 대한 핸들입니다.
[in] DeviceInfoData
삭제할 DeviceInfoSet 의 디바이스 정보 요소를 나타내는 SP_DEVINFO_DATA 구조체에 대한 포인터입니다.
반환 값
함수가 성공하면 TRUE 를 반환합니다. 그렇지 않으면 FALSE 를 반환하고 GetLastError를 호출하여 기록된 오류를 검색할 수 있습니다.
설명
지정된 디바이스 정보 요소가 사용 중인 경우(예: 마법사 페이지에서) 함수가 실패합니다. 이 경우 GetLastError 호출은 ERROR_DEVINFO_DATA_LOCKED 반환합니다. 이 문제는 이 디바이스 정보 요소가 지정되고 DIWP_FLAG_USE_DEVINFO_DATA 플래그가 설정된 SetupDiGetWizardPage 호출과 함께 마법사 페이지에 대한 핸들을 검색하는 경우에 발생합니다. 이 디바이스 정보 요소를 삭제하려면 먼저 마법사의 HPROPSHEETPAGE 핸들을 닫아야 합니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Microsoft Windows 2000 이상 버전의 Windows에서 사용할 수 있습니다. |
대상 플랫폼 | 데스크톱 |
머리글 | setupapi.h(Setupapi.h 포함) |
라이브러리 | Setupapi.lib |
DLL | Setupapi.dll |