Función PSGetPropertyDescriptionListFromString (propsys.h)

Obtiene una instancia de una interfaz de lista de descripción de propiedades para una lista de propiedades especificada.

Sintaxis

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

Parámetros

[in] pszPropList

Tipo: LPCWSTR

Puntero a una cadena Unicode terminada en null que identifica la lista de propiedades. Vea IPropertySystem::GetPropertyDescriptionListFromString para obtener más información sobre el formato de este parámetro.

[in] riid

Tipo: REFIID

Referencia al identificador de interfaz de la interfaz solicitada.

[out] ppv

Tipo: void**

Cuando se devuelve esta función, contiene el puntero de interfaz solicitado en riid. Normalmente, es IPropertyDescriptionList.

Valor devuelto

Tipo: PSSTDAPI

Devuelve uno de los valores siguientes.

Código devuelto	Descripción
S_OK	Se obtuvo la interfaz .
E_INVALIDARG	El parámetro ppv es NULL.

Comentarios

Esta función llama a la implementación del subsistema de propiedades de IPropertySystem::GetPropertyDescriptionListFromString para obtener una colección de propiedades proporcionadas como una cadena de lista de propiedades delimitada por punto y coma.

Se recomienda usar la macro IID_PPV_ARGS , definida en Objbase.h, para empaquetar los parámetros riid y ppv . Esta macro proporciona el IID correcto basado en la interfaz a la que apunta el valor de ppv, lo que elimina la posibilidad de un error de codificación.

Para obtener más información sobre los esquemas de propiedad, vea Esquemas de propiedades.

Ejemplos

En el ejemplo siguiente, para incluirse como parte de un programa mayor, se muestra cómo usar 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();
}

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP con SP2, Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 con SP1 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	propsys.h
Library	Propsys.lib
Archivo DLL	Propsys.dll (versión 5.0 o posterior)
Redistribuible	Windows Desktop Search (WDS) 3.0