다음을 통해 공유

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 호출하여 레이아웃 파일을 열어야 .

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

메모

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

요구 사항

요구 값
지원되는 최소 클라이언트 Microsoft Windows 2000 이상 버전의 Windows에서 사용할 수 있습니다.
대상 플랫폼 바탕 화면
헤더 setupapi.h(Setupapi.h 포함)
라이브러리 Setupapi.lib

참고 항목

setupDiCreateDeviceInterface

SetupDiDeleteDeviceInterfaceRegKey

setupDiOpenDeviceInterfaceRegKey