Metodo IPropertySystem::GetPropertyDescriptionByName (propsys.h)

Articolo
03/15/2023

Ottiene un'istanza dell'oggetto sottosistema che implementa IPropertyDescription, per ottenere la descrizione della proprietà per un determinato nome canonico.

Sintassi

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

Parametri

[in] pszCanonicalName

Tipo: LPCWSTR

Puntatore a una stringa che identifica la proprietà.

[in] riid

Tipo: REFIID

Riferimento all'IID desiderato.

[out] ppv

Tipo: void**

Indirizzo di un puntatore all'interfaccia IPropertyDescription .

Valore restituito

Tipo: PSSTDAPI

Restituisce uno dei valori seguenti.

Codice restituito	Descrizione
S_OK	Indica che l'interfaccia viene ottenuta.
E_INVALIDARG	Indica che pszCanonicalName è NULL.
TYPE_E_ELEMENTNOTFOUND	Indica che il nome canonico non esiste nella cache del sottosistema dello schema.

Commenti

È consigliabile usare la macro IID_PPV_ARGS, definita in objbase.h, per creare un pacchetto dei parametri riid e ppv . Questa macro fornisce l'IID corretto in base all'interfaccia a cui punta il valore in ppv, eliminando la possibilità di un errore di codifica.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP con SP2, Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 con SP1 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	propsys.h
DLL	Propsys.dll (versione 5.0 o successiva)
Componente ridistribuibile	Windows Desktop Search (WDS) 3.0

Vedi anche

IPropertySystem

Condividi tramite