SHCreatePropSheetExtArray 함수(shlobj.h)

[SHCreatePropSheetExtArray 는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다.]

지정된 레지스트리 키 아래에 있는 모든 Shell 속성 시트 확장 처리기를 로드합니다.

구문

HPSXA SHCreatePropSheetExtArray(
  [in]           HKEY   hKey,
  [in, optional] PCWSTR pszSubKey,
                 UINT   max_iface
);

매개 변수

[in] hKey

형식: HKEY

속성 시트 확장 처리기가 있는 하위 키가 포함된 레지스트리 루트 키입니다. instance 경우 HKEY_LOCAL_MACHINE.

[in, optional] pszSubKey

형식: PCWSTR

shellex\PropertySheetHandlers가 포함된 하위 키의 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다.

예를 들어 hkey 가 HKEY_LOCAL_MACHINE 지정하고 pszSubkey 가 "Software\Microsoft\Windows\CurrentVersion\Controls Folder\Display"를 지정하는 경우 이 함수는 다음 하위 키를 사용하여 속성 시트 확장 처리기를 반환합니다.

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         Windows
            CurrentVersion
               Controls Folder
                  Display
                     shellex
                        PropertySheetHandlers

max_iface

형식: UINT

반환할 속성 시트 처리기의 최대 수입니다.

반환 값

형식: HPSXA

속성 시트 처리기의 배열에 대한 핸들을 반환합니다. 이 값을 SHAddFromPropSheetExtArray에 전달합니다. 이 값에 직접 액세스하지 않습니다.

설명

반환된 HPSXA 핸들을 마치면 SHDestroyPropSheetExtArray를 호출하여 삭제합니다.

이 함수는 최대 max_iface 속성 시트 확장을 배열로 로드한 다음 SHAddFromPropSheetExtArray에 전달됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shlobj.h
라이브러리	Shell32.lib
DLL	Shell32.dll(버전 5.0 이상)