SetupDiGetClassRegistryPropertyW 함수(setupapi.h)

아티클
11/20/2024

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

통사론

WINSETUPAPI BOOL SetupDiGetClassRegistryPropertyW(
  [in]            const GUID *ClassGuid,
  [in]            DWORD      Property,
  [out, optional] PDWORD     PropertyRegDataType,
  [out]           PBYTE      PropertyBuffer,
  [in]            DWORD      PropertyBufferSize,
  [out, optional] PDWORD     RequiredSize,
  [in, optional]  PCWSTR     MachineName,
                  PVOID      Reserved
);

매개 변수

[in] ClassGuid

속성을 검색할 디바이스 설정 클래스를 나타내는 GUID에 대한 포인터입니다.

[in] Property

검색할 속성을 식별하는 값입니다. 다음 값 중 하나여야 합니다.

SPCRP_CHARACTERISTICS

이 함수는 클래스의 디바이스 특성을 나타내는 플래그를 반환합니다. 특성 플래그 목록은 IoCreateDeviceDeviceCharacteristics 매개 변수를 참조하세요.

SPCRP_DEVTYPE

이 함수는 클래스의 디바이스 유형을 나타내는 DWORD 값을 반환합니다. 자세한 내용은 디바이스 유형 지정을 참조하세요.

SPCRP_EXCLUSIVE

이 함수는 사용자가 이 클래스의 디바이스에 대한 단독 액세스를 얻을 수 있는지 여부를 나타내는 DWORD 값을 반환합니다. 배타적 액세스가 허용되는 경우 반환된 값이 1이거나, 그렇지 않으면 0입니다.

SPCRP_LOWERFILTERS

(Windows Vista 이상) 이 함수는 디바이스 설정 클래스에 대해 설치된 하위 필터 드라이버의 서비스 이름 REG_MULTI_SZ 목록을 반환합니다.

SPCRP_SECURITY

이 함수는 디바이스의 보안 설명자를 자체 상대 형식의 SECURITY_DESCRIPTOR 구조로 반환합니다(Microsoft Windows SDK 설명서에 설명됨).

SPCRP_SECURITY_SDS

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

SPCRP_UPPERFILTERS

(Windows Vista 이상) 이 함수는 디바이스 설정 클래스에 대해 설치된 상위 필터 드라이버의 서비스 이름 REG_MULTI_SZ 목록을 반환합니다.

[out, optional] PropertyRegDataType

속성 데이터 형식을 REG_ 접두사 레지스트리 데이터 형식 중 하나로 수신하는 DWORD 형식의 변수에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL수 있습니다. 이 매개 변수가 NULL경우 SetupDiGetClassRegistryProperty 데이터 형식을 반환하지 않습니다.

[out] PropertyBuffer

요청된 속성을 받는 버퍼에 대한 포인터입니다.

[in] PropertyBufferSize

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

[out, optional] RequiredSize

PropertyBuffer 버퍼의 필요한 크기(바이트)를 수신하는 DWORD 형식 변수에 대한 포인터입니다. PropertyBuffer 버퍼가 너무 작고 RequiredSize NULL않으면 함수는 RequiredSize 요청된 속성을 받는 데 필요한 최소 버퍼 크기로 설정합니다.

[in, optional] MachineName

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

주의

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

Reserved

예약됨, NULL합니다.

반환 값

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

발언

메모

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

요구 사항

요구	값
지원되는 최소 클라이언트	Windows XP 이상 버전의 Windows에서 사용할 수 있습니다.
대상 플랫폼	DesktopFor 유니버설, CM_Get_Class_Registry_Property 호출
헤더	setupapi.h(Setupapi.h 포함)
라이브러리	Setupapi.lib

참고 항목

SetupDiGetDeviceRegistryProperty

SetupDiSetClassRegistryProperty

SetupDiSetDeviceRegistryProperty

다음을 통해 공유