다음을 통해 공유

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