SHObjectProperties-Funktion (shlobj_core.h)

  • Artikel

[SHObjectProperties 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.]

Ruft den Kontextmenübefehl Eigenschaften für ein Shell-Objekt auf.

Syntax

BOOL SHObjectProperties(
  [in] HWND   hwnd,
  [in] DWORD  shopObjectType,
  [in] PCWSTR pszObjectName,
  [in] PCWSTR pszPropertyPage
);

Parameter

[in] hwnd

Typ: HWND

Das Handle des übergeordneten Fensters des Dialogfelds. Dieser Wert kann NULL sein.

[in] shopObjectType

Art: DWORD

Ein Flagwert, der den Typ des Objekts angibt.

SHOP_PRINTERNAME

pszObjectName enthält den Anzeigenamen eines Druckers.

SHOP_FILEPATH

pszObjectName enthält einen vollqualifizierten Dateinamen.

SHOP_VOLUMEGUID

pszObjectName enthält entweder (a) einen Volumenamen im Format \?\Volume{GUID}, wobei {GUID} ein global eindeutiger Bezeichner ist (z. B. "\?\Volume{2eca078d-5cbc-43d3-aff8-7e8511f60d0e})" oder (b) ein Laufwerkspfad (z. B. "C:").

[in] pszObjectName

Typ: PCWSTR

Eine mit NULL endende Unicode-Zeichenfolge, die den Objektnamen enthält. Der Inhalt der Zeichenfolge wird durch das in shopObjectType festgelegte Flag bestimmt.

[in] pszPropertyPage

Typ: PCWSTR

Eine unicode-Zeichenfolge mit Null-Endung, die den Namen der Eigenschaftenblattseite enthält, die zunächst geöffnet werden soll. Legen Sie diesen Parameter auf NULL fest, um die Standardseite anzugeben.

Rückgabewert

Typ: BOOL

TRUE , wenn der Befehl erfolgreich aufgerufen wurde; andernfalls FALSE.

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_core.h (shlobj.h einschließen)
Bibliothek Shell32.lib
DLL Shell32.dll (Version 5.0 oder höher)