IPropertySystem::GetPropertyDescriptionByName-Methode (propsys.h)

Artikel
03/01/2024

Ruft eine instance des Subsystemobjekts ab, das IPropertyDescription implementiert, um die Eigenschaftenbeschreibung für einen bestimmten kanonischen Namen abzurufen.

Syntax

HRESULT GetPropertyDescriptionByName(
  [in]  LPCWSTR pszCanonicalName,
  [in]  REFIID  riid,
  [out] void    **ppv
);

Parameter

[in] pszCanonicalName

Typ: LPCWSTR

Ein Zeiger auf eine Zeichenfolge, die die Eigenschaft identifiziert.

[in] riid

Typ: REFIID

Ein Verweis auf die gewünschte IID.

[out] ppv

Typ: void**

Die Adresse eines IPropertyDescription-Schnittstellenzeigers .

Rückgabewert

Typ: PSSTDAPI

Gibt einen der folgenden Werte zurück.

Rückgabecode	BESCHREIBUNG
S_OK	Gibt an, dass die Schnittstelle abgerufen wird.
E_INVALIDARG	Gibt an , dass pszCanonicalNameNULL ist.
TYPE_E_ELEMENTNOTFOUND	Gibt an, dass der kanonische Name nicht im Schemasubsystemcache vorhanden 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 vermieden 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
DLL	Propsys.dll (Version 5.0 oder höher)
Verteilbare Komponente	Windows Desktop Search (WDS) 3.0

Weitere Informationen

IPropertySystem

Freigeben über