SHOpenPropSheetW-Funktion (shlobj.h)

Artikel
08/26/2023

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

Erstellt ein Eigenschaftenblatt aus einer Liste von Registrierungsschlüsseln, die die CLSIDsder einzelnen Blätter enthalten, und öffnet dann das Eigenschaftenblatt.

Syntax

BOOL SHOpenPropSheetW(
  [in, optional] LPCWSTR       pszCaption,
  [in, optional] HKEY []       ahkeys,
                 UINT          ckeys,
  [in, optional] const CLSID   *pclsidDefault,
  [in]           IDataObject   *pdtobj,
  [in, optional] IShellBrowser *psb,
  [in, optional] LPCWSTR       pStartPage
);

Parameter

[in, optional] pszCaption

Typ: LPCTSTR

Ein Zeiger auf eine Zeichenfolge, die die Untertitel für das Eigenschaftenblatt enthält. Dieser Wert kann NULL sein, wenn keine Untertitel erforderlich ist.

[in, optional] ahkeys

Typ: HKEY[]

Ein Array von Registrierungsschlüsseln, die die CLSIDsder einzelnen Eigenschaftenblätter darstellen.

ckeys

Typ: UINT

UINT-Wert , der die Anzahl der Eigenschaftenblätter in dem array angibt, das von ahkeys angegeben wird.

[in, optional] pclsidDefault

Typ: const CLSID*

Ein Zeiger auf die Standard-CLSID. Dieser Wert kann NULL sein.

[in] pdtobj

Typ: IDataObject*

Ein Zeiger auf ein IDataObject, ein OLE-Objekt, das zum Ausführen von Aktionen auf den Eigenschaftenblättern verwendet werden kann.

[in, optional] psb

Typ: IShellBrowser*

Wird nicht verwendet.

[in, optional] pStartPage

Typ: LPCTSTR

Ein Zeiger auf eine Zeichenfolge, die die Startseite angibt. Dieser Wert kann NULL sein.

Rückgabewert

Typ: BOOL

Gibt TRUE zurück, wenn das Eigenschaftenblatt erfolgreich erstellt wurde. andernfalls FALSE.

Hinweise

Hinweis

Der shlobj.h-Header definiert SHOpenPropSheet als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

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)

Share via