SetupDiUnremoveDevice 함수(setupapi.h)

SetupDiUnremoveDevice 함수는 DIF_UNREMOVE 설치 요청에 대한 기본 처리기입니다.

구문

WINSETUPAPI BOOL SetupDiUnremoveDevice(
  [in]      HDEVINFO         DeviceInfoSet,
  [in, out] PSP_DEVINFO_DATA DeviceInfoData
);

매개 변수

[in] DeviceInfoSet

복원하고 다시 시작할 디바이스를 나타내는 디바이스 정보 요소가 포함된 로컬 시스템의 디바이스 정보 집합 에 대한 핸들입니다.

[in, out] DeviceInfoData

DeviceInfoSet에서 디바이스 정보 요소를 지정하는 SP_DEVINFO_DATA 구조체에 대한 포인터입니다. DeviceInfoData 때문에 IN-OUT 매개 변수입니다.DevInst는 반환될 때 새 핸들 값으로 업데이트될 수 있습니다.

반환 값

함수가 성공하면 TRUE 를 반환합니다. 그렇지 않으면 FALSE 를 반환하고 GetLastError를 호출하여 기록된 오류를 검색할 수 있습니다.

설명

SetupDiUnremoveDevice 는 디바이스를 하드웨어 프로필로 복원합니다. 이 함수는 가능한 경우 디바이스를 시작하거나 디바이스 설치 매개 변수에 플래그를 설정하여 결국 사용자에게 시스템을 종료하라는 메시지가 표시됩니다.

참고 클래스 설치 관리자만 SetupDiUnremoveDevice를 호출해야 하며, SetupDiUnremoveDevice가 기본 디바이스 수정 해제 작업을 완료한 후에는 클래스 설치 관리자가 디바이스 수정되지 않은 작업을 수행해야 하는 경우에만 호출해야 합니다. 이러한 경우 클래스 설치 관리자는 설치 관리자가 DIF_UNREMOVE 요청을 처리할 때 SetupDiUnremoveDevice 를 직접 호출해야 합니다. 기본 처리기를 호출하는 방법에 대한 자세한 내용은 기본 DIF 코드 처리기 호출을 참조하세요.

 

복원되는 디바이스에는 DIF_UNREMOVE 대한 클래스 설치 매개 변수가 있어야 합니다. 그렇지 않으면 함수가 실패하고 GetLastError가 ERROR_NO_CLASSINSTALL_PARAMS 반환합니다.

DeviceInfoSet에는 로컬 컴퓨터의 요소만 포함되어야 합니다.

SetupDiUnremoveDevice의 호출자는 Administrators 그룹의 구성원이어야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Microsoft Windows 2000 이상 버전의 Windows에서 사용할 수 있습니다.
대상 플랫폼	데스크톱
머리글	setupapi.h(Setupapi.h 포함)
라이브러리	Setupapi.lib
DLL	Setupapi.dll

추가 정보

DIF_UNREMOVE

SP_DEVINFO_DATA

SetupDiRemoveDevice