SetupDiCreateDeviceInterfaceRegKeyA 함수(setupapi.h)

SetupDiCreateDeviceInterfaceRegKey 함수는 디바이스 인터페이스에 대한 정보를 저장하기 위한 레지스트리 키를 만들고 키에 대한 핸들을 반환합니다.

구문

WINSETUPAPI HKEY SetupDiCreateDeviceInterfaceRegKeyA(
  [in]           HDEVINFO                  DeviceInfoSet,
  [in]           PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
                 DWORD                     Reserved,
  [in]           REGSAM                    samDesired,
  [in, optional] HINF                      InfHandle,
  [in, optional] PCSTR                     InfSectionName
);

매개 변수

[in] DeviceInfoSet

레지스트리 키를 만들 인터페이스가 포함된 디바이스 정보 집합 에 대한 핸들입니다. 디바이스 정보 집합에는 원격 요소가 포함되어서는 안됩니다.

[in] DeviceInterfaceData

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

Reserved

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

[in] samDesired

호출자가 생성되는 키에 대해 요청하는 레지스트리 보안 액세스입니다. REGSAM 형식의 레지스트리 보안 액세스 값에 대한 자세한 내용은 Microsoft Windows SDK 설명서를 참조하세요.

[in, optional] InfHandle

새로 만든 키에 대해 실행할 DDInstall 섹션이 포함된 열린 INF 파일에 대한 핸들입니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다. 이 매개 변수가 NULL이 아니면 InfSectionName 도 지정해야 합니다.

[in, optional] InfSectionName

InfHandle에서 지정한 INF 파일의 INF DDInstall 섹션 이름에 대한 포인터입니다. 이 섹션은 새로 만든 키에 대해 실행됩니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다. 이 매개 변수를 지정하는 경우 InfHandle 도 지정해야 합니다.

반환 값

SetupDiCreateDeviceInterfaceRegKey가 성공하면 함수는 인터페이스 정보를 저장하고 검색할 수 있는 요청된 레지스트리 키에 대한 핸들을 반환합니다. SetupDiCreateDeviceInterfaceRegKey가 실패하면 함수는 INVALID_HANDLE_VALUE 반환합니다. GetLastError를 호출하여 확장 오류 정보를 가져옵니다.

설명

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

디바이스 인터페이스에 대해 요청된 키가 이미 있는 경우 SetupDiCreateDeviceInterfaceRegKey 는 해당 키에 대한 핸들을 반환합니다. 그렇지 않으면 SetupDiCreateDeviceInterfaceRegKey 가 지정된 디바이스 인터페이스에 대한 새 비휘발성 레지스트리 키를 만듭니다. 이 함수의 호출자는 이 키에 디바이스 인터페이스에 대한 프라이빗 구성 데이터를 저장할 수 있습니다. 디바이스의 드라이버는 IoXxx 루틴을 사용하여 이 키에 액세스할 수 있습니다.

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

레이아웃 파일을 사용하는 설치의 경우(INF 버전 섹션의 LayoutFile 항목에 의해 지정됨) SetupDiCreateDeviceInterfaceRegKey가 호출되기 전에 SetupOpenAppendInfFile(Windows SDK 설명서에 설명됨)을 호출하여 레이아웃 파일을 열어야 합니다.

DeviceInfoSet에서 지정한 디바이스 정보 집합에는 로컬 컴퓨터의 요소만 포함되어야 합니다.

참고

setupapi.h 헤더는 SETUPDiCreateDeviceInterfaceRegKey를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

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

추가 정보

SetupDiCreateDeviceInterface

SetupDiDeleteDeviceInterfaceRegKey

SetupDiOpenDeviceInterfaceRegKey