SetupDiOpenDeviceInterfaceRegKey 함수(setupapi.h)

  • 아티클

SetupDiOpenDeviceInterfaceRegKey 함수는 애플리케이션 및 드라이버가 디바이스 인터페이스와 관련된 정보를 저장하는 데 사용하는 레지스트리 하위 키를 엽니다.

구문

WINSETUPAPI HKEY SetupDiOpenDeviceInterfaceRegKey(
  [in] HDEVINFO                  DeviceInfoSet,
  [in] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
       DWORD                     Reserved,
  [in] REGSAM                    samDesired
);

매개 변수

[in] DeviceInfoSet

레지스트리 하위 키를 열 디바이스 인터페이스를 포함하는 디바이스 정보 집합 에 대한 포인터입니다.

[in] DeviceInterfaceData

디바이스 인터페이스를 지정하는 SP_DEVICE_INTERFACE_DATA 구조체에 대한 포인터입니다. 이 포인터는 SetupDiCreateDeviceInterface 또는 SetupDiEnumDeviceInterfaces에서 반환할 수 있습니다.

Reserved

예약되어 있습니다. 0이어야 합니다.

[in] samDesired

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

반환 값

SetupDiOpenDeviceInterfaceRegKey 는 열린 레지스트리 키에 대한 핸들을 반환합니다. 함수가 실패하면 INVALID_HANDLE_VALUE 반환합니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

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

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

요구 사항

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

추가 정보

SetupDiCreateDeviceInterface

SetupDiCreateDeviceInterfaceRegKey

SetupDiEnumDeviceInterfaces