SetupDiOpenDevRegKey 함수(setupapi.h)

아티클
08/26/2023

SetupDiOpenDevRegKey 함수는 디바이스별 구성 정보에 대한 레지스트리 키를 엽니다.

구문

WINSETUPAPI HKEY SetupDiOpenDevRegKey(
  [in] HDEVINFO         DeviceInfoSet,
  [in] PSP_DEVINFO_DATA DeviceInfoData,
  [in] DWORD            Scope,
  [in] DWORD            HwProfile,
  [in] DWORD            KeyType,
  [in] REGSAM           samDesired
);

매개 변수

[in] DeviceInfoSet

레지스트리 키를 열 디바이스를 나타내는 디바이스 정보 요소가 포함된 디바이스 정보 집합 에 대한 핸들입니다.

[in] DeviceInfoData

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

[in] Scope

열 레지스트리 키의 scope. scope 정보가 저장되는 위치를 결정합니다. scope 전역 또는 하드웨어 프로필과 관련될 수 있습니다. scope 다음 값 중 하나로 지정됩니다.

DICS_FLAG_GLOBAL

키를 열어 전역 구성 정보를 저장합니다. 이 정보는 특정 하드웨어 프로필에만 해당되지 않습니다. 그러면 HKEY_LOCAL_MACHINE 루팅된 키가 열립니다 . 열린 정확한 키는 KeyType 매개 변수의 값에 따라 달라집니다.

DICS_FLAG_CONFIGSPECIFIC

키를 열어 하드웨어 프로필 관련 구성 정보를 저장합니다. 이 키는 HKEY_LOCAL_MACHINE 대신 하드웨어 프로필 특정 분기 중 하나에 루팅됩니다. 열린 정확한 키는 KeyType 매개 변수의 값에 따라 달라집니다.

[in] HwProfile

다음과 같이 설정된 하드웨어 프로필 값입니다.

Scope가 DICS_FLAG_CONFIGSPECIFIC 설정된 경우 HwProfile은 열 키의 하드웨어 프로필을 지정합니다.
HwProfile이 0이면 현재 하드웨어 프로필의 키가 열립니다.
Scope가 DICS_FLAG_GLOBAL 경우 HwProfile은 무시됩니다.

[in] KeyType

열 레지스트리 스토리지 키의 유형이며 다음 값 중 하나일 수 있습니다.

DIREG_DEV

디바이스에 대한 하드웨어 키를 엽니다.

DIREG_DRV

디바이스에 대한 소프트웨어 키를 엽니다.

디바이스의 하드웨어 및 소프트웨어 키에 대한 자세한 내용은 디바이스 및 드라이버용 레지스트리 트리 및 키를 참조하세요.

[in] samDesired

요청된 키에 필요한 레지스트리 보안 액세스입니다. REGSAM 형식의 레지스트리 보안 액세스 값에 대한 자세한 내용은 Microsoft Windows SDK 설명서를 참조하세요.

반환 값

함수가 성공하면 이 디바이스 instance 대한 프라이빗 구성 데이터를 저장/검색할 수 있는 열린 레지스트리 키에 대한 핸들을 반환합니다.

함수가 실패하면 INVALID_HANDLE_VALUE 반환합니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

samDesired 매개 변수에 전달되는 값에 따라 이 함수의 호출자가 Administrators 그룹의 구성원이어야 할 수 있습니다.

RegCloseKey를 호출하여 이 함수에서 반환된 핸들을 닫습니다.

이 함수가 호출되기 전에 지정된 디바이스 instance 등록해야 합니다. 그러나 운영 체제는 PnP 디바이스 인스턴스를 자동으로 등록합니다. PnP가 아닌 디바이스 인스턴스를 등록하는 방법에 대한 자세한 내용은 SetupDiRegisterDeviceInfo를 참조하세요.

요구 사항


지원되는 최소 클라이언트	Microsoft Windows 2000 이상 버전의 Windows에서 사용할 수 있습니다.
대상 플랫폼	DesktopFor universal, call CM_Open_DevNode_Key
머리글	setupapi.h(Setupapi.h 포함)
라이브러리	Setupapi.lib
DLL	Setupapi.dll
API 세트	ext-ms-win-setupapi-classinstallers-l1-1-2(Windows 10 버전 10.0.14393에 도입됨)