SetupDiGetClassDevPropertySheetsA 함수(setupapi.h)

SetupDiGetClassDevPropertySheets 함수는 디바이스 정보 요소의 속성 시트 또는 디바이스 정보 집합의 디바이스 설정 클래스에 대한 핸들을 검색합니다.

구문

WINSETUPAPI BOOL SetupDiGetClassDevPropertySheetsA(
  [in]            HDEVINFO           DeviceInfoSet,
  [in, optional]  PSP_DEVINFO_DATA   DeviceInfoData,
  [in]            LPPROPSHEETHEADERA PropertySheetHeader,
  [in]            DWORD              PropertySheetHeaderPageListSize,
  [out, optional] PDWORD             RequiredSize,
  [in]            DWORD              PropertySheetType
);

매개 변수

[in] DeviceInfoSet

속성 시트 핸들을 반환할 디바이스 정보 집합 에 대한 핸들입니다. DeviceInfoData가 디바이스 정보 집합에 디바이스 정보 요소를 지정하지 않으면 디바이스 정보 집합에 연결된 디바이스 설정 클래스가 있어야 합니다.

[in, optional] DeviceInfoData

DeviceInfoSet에서 디바이스 정보 요소를 지정하는 SP_DEVINFO_DATA 구조체에 대한 포인터입니다.

이 매개 변수는 선택 사항이며 NULL일 수 있습니다. 이 매개 변수를 지정하면 SetupDiGetClassDevPropertySheets 는 지정된 디바이스와 연결된 속성 시트 핸들을 검색합니다. 이 매개 변수가 NULL이면 SetupDiGetClassDevPropertySheets 는 DeviceInfoSet에 지정된 디바이스 설정 클래스와 연결된 속성 시트 핸들을 검색합니다.

[in] PropertySheetHeader

PROPERTYSHEETHEADER 구조체에 대한 포인터입니다. 이 구조 체와 연결된 속성 시트 핸들의 호출자 제공 배열에 대한 자세한 내용은 설명 섹션을 참조하세요.

이 구조 및 속성 시트에 대한 자세한 내용은 Microsoft Windows SDK 참조하세요.

[in] PropertySheetHeaderPageListSize

호출자가 제공한 속성 시트 핸들 배열이 보유할 수 있는 최대 핸들 수입니다.

[out, optional] RequiredSize

지정된 디바이스 정보 요소 또는 지정된 디바이스 정보 집합의 디바이스 설정 클래스와 연결된 속성 시트 수를 수신하는 DWORD 형식의 변수에 대한 포인터입니다. 포인터는 선택 사항이며 NULL일 수 있습니다.

[in] PropertySheetType

다음 유형의 속성 시트 중 하나를 나타내는 플래그입니다.

속성 시트 유형	의미
DIGCDP_FLAG_ADVANCED	고급 속성 시트.
DIGCDP_FLAG_BASIC	기본 속성 시트입니다. Microsoft Windows 95 및 Windows 98에서만 지원됩니다. Windows 2000 이상 버전의 Windows에서는 를 사용하지 마세요.
DIGCDP_FLAG_REMOTE_ADVANCED	원격 컴퓨터의 고급 속성 시트입니다.

반환 값

함수는 성공하면 TRUE 를 반환합니다. 그렇지 않으면 함수는 FALSE를 반환 합니다. GetLastError를 호출하여 오류 코드를 가져옵니다.

설명

PROPERTYSHEETHEADER 구조체에는 함수가 속성 시트의 핸들을 반환하는 데 사용하는 호출자 제공 배열과 연결된 두 개의 멤버가 포함됩니다. phpages 멤버는 호출자가 제공한 속성 시트 핸들 배열에 대한 포인터이며 nPages 멤버의 입력 값은 핸들 배열에 이미 포함된 핸들 수를 지정합니다. 함수는 배열 인덱스가 nPages의 입력 값인 배열 요소로 시작하는 핸들 배열에 속성 시트 핸들을 추가합니다. 함수는 배열이 가득 차거나 요청된 모든 속성 시트 페이지의 핸들이 배열에 추가될 때까지 연속 순서로 배열에 핸들을 추가합니다. 함수가 반환할 수 있는 속성 시트 핸들의 최대 수는 (PropertySheetHeaderPageListSize - ( nPages의 입력 값))과 같습니다.

핸들 배열이 요청된 모든 속성 시트 페이지의 핸들을 보유할 만큼 충분히 큰 경우 함수는 다음을 수행합니다.

• 핸들 배열에 핸들을 추가합니다.
• nPages를 배열의 총 핸들 수로 설정합니다.
• RequiredSize를 반환하는 핸들 수로 설정합니다.
• TRUE를 반환합니다.

핸들 배열이 지정된 모든 속성 시트 페이지의 핸들을 보유할 만큼 크지 않은 경우 함수는 다음을 수행합니다.

• 배열이 보유할 수 있는 만큼의 핸들을 추가합니다.
• nPages를PropertySheetHeaderPageListSize로 설정합니다.
• RequiredSize를 요청된 속성 시트 페이지의 총 수로 설정합니다. 함수에서 반환되지 않는 핸들 수는 (RequiredSize - PropertySheetHeaderPageListSize - ( nPages의 입력 값)과 같습니다.
• 오류 코드를 ERROR_INSUFFICIENT_BUFFER 설정합니다.
• FALSE를 반환합니다.

참고

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

요구 사항

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

추가 정보

SP_DEVINFO_DATA