Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

SHCreatePropSheetExtArray function

[SHCreatePropSheetExtArray is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

Loads all the Shell property sheet extension handlers located under a specified registry key.

Syntax


HPSXA SHCreatePropSheetExtArray(
  _In_      HKEY hkey,
  _In_opt_  PCWSTR pszSubkey,
  UINT max_iface
);

Parameters

hkey [in]

Type: HKEY

The registry root key that contains the subkey with the property sheet extension handlers. For instance, HKEY_LOCAL_MACHINE.

pszSubkey [in, optional]

Type: PCWSTR

A pointer to a null-terminated string specifying the name of the subkey that contains shellex\PropertySheetHandlers.

For example, if hkey specifies HKEY_LOCAL_MACHINE and pszSubkey specifies "Software\Microsoft\Windows\CurrentVersion\Controls Folder\Display", this function returns property sheet extension handlers using the following subkey:

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         Windows
            CurrentVersion
               Controls Folder
                  Display
                     shellex
                        PropertySheetHandlers
max_iface

Type: UINT

The maximum number of property sheet handlers to be returned.

Return value

Type: HPSXA

Returns a handle to an array of property sheet handlers. Pass this value to SHAddFromPropSheetExtArray. You do not access this value directly.

Remarks

When you are finished with the returned HPSXA handle, destroy it by calling SHDestroyPropSheetExtArray.

This function loads up to max_iface property sheet extensions into an array that is then passed to SHAddFromPropSheetExtArray.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

End of client support

Windows XP with SP2

End of server support

Windows Server 2003

Header

Shlobj.h

Library

Shell32.lib

DLL

Shell32.dll (version 5.0 or later)

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.