Funzione PSGetPropertyDescriptionListFromString (propsys.h)

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.

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