SetupDiBuildClassInfoList 함수(setupapi.h)

아티클
08/26/2023

SetupDiBuildClassInfoList 함수는 로컬 컴퓨터에 설치된 클래스를 식별하는 설치 클래스 GUID 목록을 반환합니다.

구문

WINSETUPAPI BOOL SetupDiBuildClassInfoList(
  [in]            DWORD  Flags,
  [out, optional] LPGUID ClassGuidList,
  [in]            DWORD  ClassGuidListSize,
  [out]           PDWORD RequiredSize
);

매개 변수

[in] Flags

목록에서 클래스 제외를 제어하는 데 사용되는 플래그입니다. 플래그를 지정하지 않으면 모든 설정 클래스가 목록에 포함됩니다. 다음 값의 조합일 수 있습니다.

DIBCI_NOINSTALLCLASS

레지스트리 키에 NoInstallClass 값 항목이 있는 경우 클래스를 제외합니다.

DIBCI_NODISPLAYCLASS

레지스트리 키에 NoDisplayClass 값 항목이 있는 경우 클래스를 제외합니다.

[out, optional] ClassGuidList

설치 클래스 GUID 목록을 수신하는 GUID 형식 배열에 대한 포인터입니다. 이 포인터는 선택 사항이며 NULL일 수 있습니다.

[in] ClassGuidListSize

ClassGuildList 매개 변수가 가리키는 배열의 GUID 수입니다. ClassGuidList가 NULL인 경우 ClassGuidSize는 0이어야 합니다.

[out] RequiredSize

반환되는 GUID 수를 수신하는 DWORD 형식 변수에 대한 포인터입니다(숫자가 ClassGuidList 매개 변수가 가리키는 배열의 GUID 크기보다 작거나 같은 경우).

이 숫자가 ClassGuidList 배열의 크기보다 큰 경우 모든 클래스 GUID를 포함하기 위해 ClassGuidList 배열이 얼마나 커야 하는지를 나타냅니다.

반환 값

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

설명

로컬 컴퓨터에 설치된 클래스 수를 검색하려면 ClassGuidList가 NULL로 설정되고 ClassGuidSize가 0으로 설정된 SetupDiBuildClassInfoList를 호출합니다. 이러한 호출에 대한 응답으로 함수는 RequiredSize의 클래스 수를 반환합니다*.

NoUseClass 값 항목이 클래스의 레지스트리 키에 있는 경우 SetupDiBuildClassInfoList는 클래스에 대한 클래스 GUID를 반환하지 않습니다.

원격 시스템에 설치된 설치 클래스 GUID 목록을 검색하려면 SetupDiBuildClassInfoListEx를 사용합니다.

요구 사항

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