SetupDiGetHwProfileList 함수(setupapi.h)

SetupDiGetHwProfileList 함수는 현재 정의된 모든 하드웨어 프로필 ID 목록을 검색합니다.

구문

WINSETUPAPI BOOL SetupDiGetHwProfileList(
  [out]           PDWORD HwProfileList,
  [in]            DWORD  HwProfileListSize,
  [out]           PDWORD RequiredSize,
  [out, optional] PDWORD CurrentlyActiveIndex
);

매개 변수

[out] HwProfileList

현재 정의된 하드웨어 프로필 ID 목록을 받을 배열에 대한 포인터입니다.

[in] HwProfileListSize

HwProfileList 버퍼의 DWORD 수입니다.

[out] RequiredSize

현재 정의된 하드웨어 프로필 수를 수신하는 DWORD 형식의 변수에 대한 포인터입니다. 숫자가 HwProfileListSize보다 크면 배열 크기에 맞게 목록이 잘립니다. RequiredSize에서 반환된 값은 전체 하드웨어 프로필 목록을 저장하는 데 필요한 배열 크기를 나타냅니다. 이 경우 함수가 실패하고 GetLastError 를 호출하면 ERROR_INSUFFICIENT_BUFFER 반환됩니다.

[out, optional] CurrentlyActiveIndex

검색된 하드웨어 프로필 목록에서 현재 활성 하드웨어 프로필의 인덱스를 수신하는 DWORD 형식의 변수에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다.

반환 값

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

설명

SetupDiGetHwProfileListEx를 호출하여 원격 컴퓨터의 하드웨어 프로필 ID를 검색합니다.

요구 사항

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

추가 정보

SetupDiCreateDevRegKey

SetupDiOpenDevRegKey