Funzione PSGetPropertyDescriptionListFromString (propsys.h)

Articolo
03/01/2024

Ottiene un'istanza di un'interfaccia elenco di descrizioni delle proprietà per un elenco di proprietà specificato.

Sintassi

PSSTDAPI PSGetPropertyDescriptionListFromString(
  [in]  LPCWSTR pszPropList,
  [in]  REFIID  riid,
  [out] void    **ppv
);

Parametri

[in] pszPropList

Tipo: LPCWSTR

Puntatore a una stringa Unicode con terminazione null che identifica l'elenco delle proprietà. Per altre informazioni sul formato di questo parametro, vedere IPropertySystem::GetPropertyDescriptionListFromString .

[in] riid

Tipo: REFIID

Riferimento all'ID interfaccia dell'interfaccia richiesta.

[out] ppv

Tipo: void**

Quando questa funzione restituisce, contiene il puntatore dell'interfaccia richiesto in riid. Questo è in genere IPropertyDescriptionList.

Valore restituito

Tipo: PSSTDAPI

Restituisce uno dei valori seguenti.

Codice restituito	Descrizione
S_OK	L'interfaccia è stata ottenuta.
E_INVALIDARG	Il parametro ppv è NULL.

Commenti

Questa funzione chiama l'implementazione del sottosistema delle proprietà di IPropertySystem::GetPropertyDescriptionListFromString per ottenere una raccolta di proprietà fornite come stringa di elenco di proprietà delimitata da punto e virgola.

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

Per altre informazioni sugli schemi delle proprietà, vedere Schemi delle proprietà.

Esempio

Nell'esempio seguente, da includere come parte di un programma più ampio, viene illustrato come usare PSGetPropertyDescriptionListFromString.

IPropertyDescriptionList *pList;

HRESULT hr = PSGetPropertyDescriptionListFromString(L"prop:System.Title;System.Size",
                                                    IID_PPV_ARGS(&pList));
                                                    
if (SUCCEEDED(hr))
{
    // pList is now valid.
 
    pList->Release();
}

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
Libreria	Propsys.lib
DLL	Propsys.dll (versione 5.0 o successiva)
Componente ridistribuibile	Windows Desktop Search (WDS) 3.0

Condividi tramite