다음을 통해 공유

SetupDiSetDeviceRegistryPropertyW 함수(setupapi.h)

  • 아티클

SetupDiSetDeviceRegistryProperty 함수는 디바이스에 대한 플러그 앤 플레이 디바이스 속성을 설정합니다.

구문

WINSETUPAPI BOOL SetupDiSetDeviceRegistryPropertyW(
  [in]           HDEVINFO         DeviceInfoSet,
  [in, out]      PSP_DEVINFO_DATA DeviceInfoData,
  [in]           DWORD            Property,
  [in, optional] const BYTE       *PropertyBuffer,
  [in]           DWORD            PropertyBufferSize
);

매개 변수

[in] DeviceInfoSet

플러그 앤 플레이 디바이스 속성을 설정할 디바이스를 나타내는 디바이스 정보 요소가 포함된 디바이스 정보 집합에 대한 핸들입니다.

[in, out] DeviceInfoData

DeviceInfoSet에서 디바이스 정보 요소를 지정하는 SP_DEVINFO_DATA 구조체에 대한 포인터입니다. ClassGuid 속성이 설정되면 DeviceInfoData입니다.ClassGuid는 디바이스의 새 클래스로 돌아가면 설정됩니다.

[in] Property

설정할 속성을 식별하는 다음 값 중 하나입니다. 이러한 값에 대한 설명은 SetupDiGetDeviceRegistryProperty를 참조하세요.

  • SPDRP_CONFIGFLAGS
  • SPDRP_EXCLUSIVE
  • SPDRP_FRIENDLYNAME
  • SPDRP_LOCATION_INFORMATION
  • SPDRP_LOWERFILTERS
  • SPDRP_REMOVAL_POLICY_OVERRIDE
  • SPDRP_SECURITY
  • SPDRP_SECURITY_SDS
  • SPDRP_UI_NUMBER_DESC_FORMAT
  • SPDRP_UPPERFILTERS

참고

SPDRP_HARDWAREID 또는 SPDRP_COMPATIBLEIDS DeviceInfoData 가 루트 열거형 디바이스를 나타내는 경우에만 사용할 수 있습니다. 다른 디바이스의 경우 버스 드라이버는 IRP_MN_QUERY_ID 받은 후 자식 디바이스를 열거할 때 하드웨어 및 호환 ID를 보고합니다.

다음 값은 운영 체제에서 사용하도록 예약되어 있으며 Property 매개 변수에서 사용할 수 없습니다.

  • SPDRP_ADDRESS
  • SPDRP_BUSNUMBER
  • SPDRP_BUSTYPEGUID
  • SPDRP_CHARACTERISTICS
  • SPDRP_CAPABILITIES
  • SPDRP_CLASS
  • SPDRP_CLASSGUID
  • SPDRP_DEVICE_POWER_DATA
  • SPDRP_DEVICEDESC
  • SPDRP_DEVTYPE
  • SPDRP_DRIVER
  • SPDRP_ENUMERATOR_NAME
  • SPDRP_INSTALL_STATE
  • SPDRP_LEGACYBUSTYPE
  • SPDRP_LOCATION_PATHS
  • SPDRP_MFG
  • SPDRP_PHYSICAL_DEVICE_OBJECT_NAME
  • SPDRP_REMOVAL_POLICY
  • SPDRP_REMOVAL_POLICY_HW_DEFAULT
  • SPDRP_SERVICE
  • SPDRP_UI_NUMBER

[in, optional] PropertyBuffer

속성에 대한 새 데이터를 포함하는 버퍼에 대한 포인터입니다. 속성을 지우는 경우 이 포인터는 NULL 이고 PropertyBufferSize 는 0이어야 합니다.

[in] PropertyBufferSize

PropertyBuffer의 크기(바이트)입니다. PropertyBuffer가 NULL이면 이 필드는 0이어야 합니다.

반환 값

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

설명

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

클래스 이름 속성은 해당 클래스 GUID를 기반으로 하며 해당 속성이 변경될 때 자동으로 업데이트되므로 설정할 수 없습니다. ClassGUID 속성이 변경되면 SetupDiSetDeviceRegistryProperty 는 디바이스와 연결된 모든 소프트웨어 키를 자동으로 정리합니다.

참고

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

요구 사항

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

추가 정보

SetupDiGetClassRegistryProperty

SetupDiGetDeviceRegistryProperty

SetupDiSetClassRegistryProperty