Compartir a través de


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