SetupDiDeleteDevRegKey 함수(setupapi.h)

SetupDiDeleteDevRegKey 함수는 디바이스 정보 요소와 연결된 지정된 사용자 액세스 가능 레지스트리 키를 삭제합니다.

구문

WINSETUPAPI BOOL SetupDiDeleteDevRegKey(
  [in] HDEVINFO         DeviceInfoSet,
  [in] PSP_DEVINFO_DATA DeviceInfoData,
  [in] DWORD            Scope,
  [in] DWORD            HwProfile,
  [in] DWORD            KeyType
);

매개 변수

[in] DeviceInfoSet

레지스트리 키를 삭제할 디바이스 를 나타내는 디바이스 정보 요소가 포함된 디바이스 정보 집합에 대한 핸들입니다. 디바이스 정보 집합에는 원격 요소가 포함되어서는 안됩니다.

[in] DeviceInfoData

DeviceInfoSet에서 디바이스 정보 요소를 지정하는 SP_DEVINFO_DATA 구조체에 대한 포인터입니다.

[in] Scope

삭제할 레지스트리 키의 scope. scope 정보가 있는 위치를 나타냅니다. 키는 전역 또는 하드웨어 프로필에 따라 다를 수 있습니다. 다음 값 중 하나일 수 있습니다.

DICS_FLAG_GLOBAL

전역 구성 정보를 저장하는 키를 삭제합니다.

DICS_FLAG_CONFIGSPECIFIC

하드웨어 프로필 관련 구성 정보를 저장하는 키를 삭제합니다.

[in] HwProfile

Scope가 DICS_FLAG_CONFIGSPECIFIC 설정되면 HwProfile 매개 변수는 레지스트리 키를 삭제할 하드웨어 프로필을 지정합니다. HwProfile이 0이면 현재 하드웨어 프로필의 키가 삭제됩니다. HwProfile이 0xFFFFFFFF 경우 모든 하드웨어 프로필의 레지스트리 키가 삭제됩니다.

[in] KeyType

삭제할 레지스트리 스토리지 키의 유형입니다. 다음 값 중 하나일 수 있습니다.

DIREG_DEV

디바이스의 하드웨어 키를 삭제합니다.

DIREG_DRV

디바이스의 소프트웨어 키를 삭제합니다.

DIREG_BOTH

디바이스에 대한 하드웨어 및 소프트웨어 키를 모두 삭제합니다.

반환 값

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

설명

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

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

요구 사항

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

추가 정보

SetupDiCreateDevRegKey

SetupDiGetHwProfileList