IPropertySystem::GetPropertyDescriptionListFromString-Methode (propsys.h)

Ruft eine instance des Subsystemobjekts ab, das IPropertyDescriptionList implementiert, um eine geordnete Auflistung von Eigenschaftenbeschreibungen basierend auf der bereitgestellten Zeichenfolge abzurufen.

Syntax

HRESULT GetPropertyDescriptionListFromString(
  [in]  LPCWSTR pszPropList,
  [in]  REFIID  riid,
  [out] void    **ppv
);

Parameter

[in] pszPropList

Typ: LPCWSTR

Ein Zeiger auf eine Zeichenfolge, die die Eigenschaftenliste identifiziert.

[in] riid

Typ: REFIID

Ein Verweis auf die gewünschte IID.

[out] ppv

Typ: void**

Die Adresse eines IPropertyDescriptionList-Schnittstellenzeigers .

Rückgabewert

Typ: HRESULT

Gibt einen der folgenden Werte zurück.

Rückgabecode	BESCHREIBUNG
S_OK	Gibt an, dass die Schnittstelle abgerufen wird.
E_INVALIDARG	Gibt an , dass ppvNULL ist.

Hinweise

Die Syntax der Eigenschaftenbeschreibungslistenzeichenfolge ("Proplist") besteht aus einer Sequenz kanonischer Eigenschaftennamen, wobei jedem Eigenschaftsnamen Flags zugeordnet sind. Die Zeichenfolge beginnt mit "prop:". Die Syntax sieht wie folgt aus: prop:[flags]propertyname[endflags];

Die Flags sind optional und können eines der folgenden sein. Hinweis: Diese Flags werden in die PROPDESC_VIEW_FLAGS Enumeration übersetzt.

Flag	Bedeutung
-	Sortieren in umgekehrter Reihenfolge (PDVF_REVERSESORT).
0	Standardmäßig sowohl in der primären als auch in der sekundären Liste anzeigen (PDVF_SHOWBYDEFAULT | PDVF_SHOWINPRIMARYLIST | PDVF_SHOWINSECONDARYLIST).
1	Anzeigen in der primären und sekundären Liste (PDVF_SHOWINPRIMARYLIST | PDVF_SHOWINSECONDARYLIST).
2	In sekundärer Liste anzeigen (PDVF_SHOWINSECONDARYLIST).
^	Beginnen Sie eine neue Gruppe (PDVF_BEGINNEWGROUP).
/	Rechtsbündig (PDVF_RIGHTALIGN).
*	Ausblenden, wenn der Wert nicht vorhanden ist.
|	Zentrig ausrichten. (PDVF_CENTERALIGN).
~	Blenden Sie die Bezeichnung aus. (PDVF_HIDELABEL).
#	Bereich ausfüllen. (PDVF_FILLAREA).
?	Ausblenden, wenn vom Eigenschaftenhandler (PDVF_HIDEIFUNSUPPORTED) nicht unterstützt wird.
<	Analysieren als Link (PDVF_PARSEASLINK).
&	Als ganzen Link anzeigen (PDVF_SHOWASWHOLELINK).

 

Aus sicht des Dbfolders und des Dateiordners:

0	Anzeigen als Spalte im Defview-, Spaltenwählermenü und Spaltenwählerdialogfeld.
1	Anzeigen im Menü der Spaltenwährung und im Dialogfeld.
2	Im Dialogfeld "Spaltenwährer" anzeigen.
NULL	In die Suchergebnisse einschließen, aber auf der Benutzeroberfläche ausblenden.

 

Die Endflags sind ebenfalls optional und können wie folgt aussehen:

EndFlag	Bedeutung
]	Endspalte (wird für erweiterte Kachelnansicht verwendet).

 

Es wird empfohlen, das makro IID_PPV_ARGS zu verwenden, das in objbase.h definiert ist, um die Parameter riid und ppv zu packen. Dieses Makro stellt die richtige IID basierend auf der Schnittstelle bereit, auf die der Wert in ppv verweist, wodurch die Möglichkeit eines Codierungsfehlers beseitigt wird.

Weitere Informationen zu Eigenschaftenschemas finden Sie unter Eigenschaftenschemas.

Anforderungen

Unterstützte Mindestversion (Client)	Windows XP mit SP2, Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 mit SP1 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	propsys.h
DLL	Propsys.dll (Version 5.0 oder höher)
Verteilbare Komponente	Windows Desktop Search (WDS) 3.0

Weitere Informationen

IPropertySystem