SetupDiSetClassRegistryPropertyW 함수(setupapi.h)

아티클
08/26/2023

SetupDiSetClassRegistryProperty 함수는 레지스트리에서 지정된 디바이스 클래스 속성을 설정합니다.

구문

WINSETUPAPI BOOL SetupDiSetClassRegistryPropertyW(
  [in]           const GUID *ClassGuid,
  [in]           DWORD      Property,
  [in, optional] const BYTE *PropertyBuffer,
  [in]           DWORD      PropertyBufferSize,
  [in, optional] PCWSTR     MachineName,
                 PVOID      Reserved
);

매개 변수

[in] ClassGuid

속성을 설정할 디바이스 클래스를 식별하는 GUID에 대한 포인터입니다.

[in] Property

설정할 속성을 식별하는 값으로, 다음 중 하나여야 합니다.

SPCRP_CHARACTERISTICS

호출자는 클래스의 디바이스 특성을 지정하는 플래그를 제공합니다. 특성 플래그 목록은 IoCreateDevice의 DeviceCharacteristics 매개 변수를 참조하세요. 디바이스 특성은 디바이스 클래스가 설치될 때 설정해야 하며 디바이스 클래스가 설치된 후에는 변경되지 않아야 합니다.

SPCRP_DEVTYPE

호출자는 클래스에 대한 디바이스 유형을 제공합니다. 자세한 내용은 디바이스 유형 지정을 참조하세요. 디바이스 클래스가 설치될 때 디바이스 유형을 설정해야 하며 디바이스 클래스를 설치한 후에는 변경하지 않아야 합니다.

SPCRP_EXCLUSIVE

호출자는 사용자가 이 클래스의 디바이스에 대한 단독 액세스를 얻을 수 있는지 여부를 지정하는 DWORD 값을 제공합니다. 단독 액세스가 허용되는 경우 제공된 값은 1이거나, 그렇지 않으면 0입니다. 디바이스 클래스가 설치될 때 디바이스에 대한 배타적 설정을 설정해야 하며 디바이스 클래스를 설치한 후에는 변경하지 않아야 합니다.

SPCRP_LOWERFILTERS

(Windows Vista 이상) 호출자는 디바이스 설정 클래스에 대해 설치된 하위 필터 드라이버의 서비스 이름의 REG_MULTI_SZ 목록을 제공합니다. 클래스 필터 드라이버를 설치하는 방법에 대한 자세한 내용은 필터 드라이버 설치 및 INF 클래스Install32 섹션을 참조하세요.

SPCRP_SECURITY

호출자는 디바이스의 보안 설명자를 Microsoft Windows SDK 설명서에 설명된 자체 상대 형식의 SECURITY_DESCRIPTOR 구조로 제공합니다.

SPCRP_SECURITY_SDS

호출자는 디바이스의 보안 설명자를 텍스트 문자열로 제공합니다. 보안 설명자 문자열에 대한 자세한 내용은 보안 설명자 정의 언어(Windows)를 참조하세요. 보안 설명자 문자열 형식에 대한 자세한 내용은 보안 설명자 정의 언어(Windows)를 참조하세요.

SPCRP_UPPERFILTERS

(Windows Vista 이상) 호출자는 디바이스 설정 클래스에 대해 설치된 상위 필터 드라이버의 서비스 이름에 대한 REG_MULTI_SZ 목록을 제공합니다. 클래스 필터 드라이버를 설치하는 방법에 대한 자세한 내용은 필터 드라이버 설치 및 INF 클래스Install32 섹션을 참조하세요.

[in, optional] PropertyBuffer

지정된 속성을 제공하는 버퍼에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다.

[in] PropertyBufferSize

PropertyBuffer 버퍼의 크기(바이트)입니다.

[in, optional] MachineName

지정된 디바이스 클래스 속성을 설정할 원격 시스템의 이름을 포함하는 NULL로 끝나는 문자열에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다. 이 매개 변수가 NULL이면 속성은 로컬 시스템의 이름으로 설정됩니다.

주의

이 기능이 제거되었으므로 이 함수를 사용하여 원격 머신에 액세스하는 것은 Windows 8 및 Windows Server 2012 시작해도 지원되지 않습니다.

Reserved

예약된 은 NULL이어야 합니다.

반환 값

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

설명

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

디바이스 클래스 속성의 데이터 형식을 확인하려면 SetupDiGetClassRegistryProperty를 호출합니다.

참고

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

요구 사항

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

추가 정보

SetupDiGetClassRegistryProperty

SetupDiGetDeviceRegistryProperty

SetupDiSetDeviceRegistryProperty

Share via