SHCreatePropSheetExtArray-Funktion (shlobj.h)

Artikel
03/04/2024

[SHCreatePropSheetExtArray ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Lädt alle Shell-Eigenschaftenblatterweiterungshandler, die sich unter einem angegebenen Registrierungsschlüssel befinden.

Syntax

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

Parameter

[in] hKey

Typ: HKEY

Der Registrierungsstammschlüssel, der den Unterschlüssel mit den Eigenschaftenblatterweiterungshandlern enthält. Für instance HKEY_LOCAL_MACHINE.

[in, optional] pszSubKey

Typ: PCWSTR

Ein Zeiger auf eine NULL-Zeichenfolge, die den Namen des Unterschlüssels angibt, der shellex\PropertySheetHandlers enthält.

Wenn beispielsweise hkey angibt, HKEY_LOCAL_MACHINE und pszSubkey "Software\Microsoft\Windows\CurrentVersion\Controls Folder\Display" angibt, gibt diese Funktion Eigenschaftenblatterweiterungshandler mit dem folgenden Unterschlüssel zurück:

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         Windows
            CurrentVersion
               Controls Folder
                  Display
                     shellex
                        PropertySheetHandlers

max_iface

Typ: UINT

Die maximale Anzahl von Eigenschaftenblatthandlern, die zurückgegeben werden sollen.

Rückgabewert

Typ: HPSXA

Gibt ein Handle an ein Array von Eigenschaftenblatthandlern zurück. Übergeben Sie diesen Wert an SHAddFromPropSheetExtArray. Sie greifen nicht direkt auf diesen Wert zu.

Hinweise

Wenn Sie mit dem zurückgegebenen HPSXA-Handle fertig sind, zerstören Sie es, indem Sie SHDestroyPropSheetExtArray aufrufen.

Diese Funktion lädt bis zu max_iface Eigenschaftenblatterweiterungen in ein Array, das dann an SHAddFromPropSheetExtArray übergeben wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlobj.h
Bibliothek	Shell32.lib
DLL	Shell32.dll (Version 5.0 oder höher)

Freigeben über