SHOpenPropSheetW-Funktion (shlobj.h)

Artikel
11/20/2024

[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 CLSID-der 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 Beschriftung für das Eigenschaftenblatt enthält. Dieser Wert kann NULL- werden, wenn keine Beschriftung erforderlich ist.

[in, optional] ahkeys

Typ: HKEY[]

Ein Array von Registrierungsschlüsseln, die die CLSID-der einzelnen Eigenschaftenblätter darstellen.

ckeys

Typ: UINT-

UINT Wert, der die Anzahl der Eigenschaftenblätter in dem array angibt, das durch ahkeysangegeben wird.

[in, optional] pclsidDefault

Typ: const CLSID*

Ein Zeiger auf die standardmäßige CLSID-. Dieser Wert kann NULL-sein.

[in] pdtobj

Typ: IDataObject-*

Ein Zeiger auf eine 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.

Bemerkungen

Anmerkung

Der Shlobj.h-Header definiert SHOpenPropSheet als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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
mindestens unterstützte Client-	Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	shlobj.h
Library	Shell32.lib
DLL-	Shell32.dll (Version 5.0 oder höher)

Freigeben über