IShellItemArray::GetPropertyDescriptionList-Methode (shobjidl_core.h)

Artikel
03/02/2024

Ruft eine Eigenschaftenbeschreibungsliste für die Elemente im Shellelementarray ab.

Syntax

HRESULT GetPropertyDescriptionList(
  [in]  REFPROPERTYKEY keyType,
  [in]  REFIID         riid,
  [out] void           **ppv
);

Parameter

[in] keyType

Typ: REFPROPERTYKEY

Ein Verweis auf die PROPERTYKEY-Struktur , die angibt, welche Eigenschaftenliste abgerufen werden soll.

[in] riid

Typ: REFIID

Die IID des abzurufenden Objekttyps.

[out] ppv

Typ: void**

Wenn diese Methode zurückgibt, enthält die in riid angeforderte Schnittstelle. Dies ist in der Regel IPropertyDescriptionList.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Funktion wird verwendet, um eine Liste von Eigenschaften zu ermitteln, die für eine Reihe von Shellelementen gelten. Der Listentyp wird durch eine PROPERTYKEY-Struktur angegeben. Zu den unterstützten Listentypen gehören, sind jedoch nicht beschränkt auf:

PKEY_PropList_PreviewDetails
PKEY_PropList_PreviewTitle
PKEY_PropList_FullDetails
PKEY_PropList_TileInfo
PKEY_PropList_ExtendedTileInfo
PKEY_PropList_InfoTip
PKEY_PropList_QuickTip
PKEY_PropList_FileOperationPrompt
PKEY_PropList_ConflictPrompt
PKEY_PropList_SetDefaultsFor
PKEY_PropList_NonPersonal
PKEY_NewMenuPreferredTypes
PKEY_NewMenuAllowedTypes

Wenn das Shellelementarray mehr als ein Element enthält, erhält diese Methode eine Schnittmenge der Eigenschaften, die für jedes Element einzeln zurückgegeben werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (shobjidl.h einschließen)

Weitere Informationen

IShellItemArray

Eigenschaftenlisten

Freigeben über