PSEnumeratePropertyDescriptions-Funktion (propsys.h)

Artikel
08/25/2023

Eine Wrapper-API, die IPropertySystem::EnumeratePropertyDescriptions des Schemasubsystems aufruft. Diese Funktion ruft eine instance des Subsystemobjekts ab, das IPropertyDescriptionList implementiert, um entweder die gesamte Liste oder eine partielle Liste der Eigenschaftenbeschreibungen im System abzurufen.

Syntax

PSSTDAPI PSEnumeratePropertyDescriptions(
  [in]  PROPDESC_ENUMFILTER filterOn,
  [in]  REFIID              riid,
  [out] void                **ppv
);

Parameter

[in] filterOn

Typ: PROPDESC_ENUMFILTER

Die zurückzugebende Liste. PROPDESC_ENUMFILTER zeigt die gültigen Werte für diese Methode an.

[in] riid

Typ: REFIID

Verweis auf die Schnittstellen-ID der angeforderten Schnittstelle.

[out] ppv

Typ: void**

Die Adresse eines IPropertyDescriptionList-Schnittstellenzeigers .

Rückgabewert

Typ: PSSTDAPI

Gibt einen der folgenden Werte zurück.

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

Hinweise

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.

Anforderungen

Anforderung	Wert
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
Bibliothek	Propsys.lib
DLL	Propsys.dll (Version 6.0 oder höher)
Verteilbare Komponente	Windows Desktop Search (WDS) 3.0

Share via