SetupDiSetDeviceInterfaceDefault 함수(setupapi.h)

SetupDiSetDeviceInterfaceDefault 함수는 디바이스 인터페이스 클래스의 기본 인터페이스로 디바이스 인터페이스를 설정합니다.

구문

WINSETUPAPI BOOL SetupDiSetDeviceInterfaceDefault(
  [in]      HDEVINFO                  DeviceInfoSet,
  [in, out] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
  [in]      DWORD                     Flags,
            PVOID                     Reserved
);

매개 변수

[in] DeviceInfoSet

디바이스 인터페이스 클래스의 기본값으로 설정할 디바이스 인터페이스가 포함된 디바이스 정보 집합 에 대한 핸들입니다.

[in, out] DeviceInterfaceData

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

[in] Flags

사용되지 않음, 0이어야 합니다.

Reserved

나중에 사용하도록 예약된 는 NULL이어야 합니다.

반환 값

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

설명

호출자는 디바이스 인터페이스 클래스에 대한 기본 인터페이스를 설정하려면 관리자 권한이 있어야 합니다. 그러나 요청된 기본 인터페이스가 현재 설정된 기본 인터페이스와 동일한 경우 함수는 호출자에게 관리자 권한이 있는지 여부에 관계없이 TRUE 를 반환합니다.

함수가 지정된 디바이스 인터페이스를 디바이스 클래스의 기본값으로 설정하면 제공된 SP_DEVICE_INTERFACE_DATA 구조체의 Flags 멤버를 업데이트합니다.

SetupDiGetClassDevs를 호출하여 디바이스 인터페이스 클래스의 기본값으로 설정할 디바이스 인터페이스가 포함된 디바이스 정보 집합에 대한 DevInfoSet 핸들을 가져옵니다. 디바이스 인터페이스 요소에 대한 DeviceInterfaceData 포인터를 가져오려면 SetupDiEnumDeviceInterfaces 를 호출하여 디바이스 정보 집합의 인터페이스를 열거합니다. 열거된 인터페이스에 대한 정보를 검색하려면 SetupDiGetDeviceInterfaceDetail을 호출합니다.

요구 사항

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

추가 정보

SetupDiEnumDeviceInterfaces

SetupDiGetClassDevs

SetupDiGetDeviceInterfaceDetail