Função PSGetPropertyDescriptionListFromString (propsys.h)

Obtém uma instância de uma interface de lista de descrição de propriedade para uma lista de propriedades especificada.

Sintaxe

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

Parâmetros

[in] pszPropList

Tipo: LPCWSTR

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que identifica a lista de propriedades. Consulte IPropertySystem::GetPropertyDescriptionListFromString para obter mais informações sobre o formato desse parâmetro.

[in] riid

Tipo: REFIID

Referência à ID da interface solicitada.

[out] ppv

Tipo: void**

Quando essa função retorna, contém o ponteiro de interface solicitado em riid. Normalmente, isso é IPropertyDescriptionList.

Retornar valor

Tipo: PSSTDAPI

Retorna um dos valores a seguir.

Código de retorno	Descrição
S_OK	A interface foi obtida.
E_INVALIDARG	O parâmetro ppv é NULL.

Comentários

Essa função chama a implementação do subsistema de propriedade de IPropertySystem::GetPropertyDescriptionListFromString para obter uma coleção de propriedades fornecidas como uma cadeia de caracteres de lista de propriedades delimitada por ponto e vírgula.

Recomendamos que você use a macro IID_PPV_ARGS , definida em Objbase.h, para empacotar os parâmetros riid e ppv . Essa macro fornece o IID correto com base na interface apontada pelo valor em ppv, o que elimina a possibilidade de um erro de codificação.

Para obter mais informações sobre esquemas de propriedade, consulte Esquemas de propriedade.

Exemplos

O exemplo a seguir, a ser incluído como parte de um programa maior, demonstra como 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	Valor
Cliente mínimo com suporte	Windows XP com SP2, Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 com SP1 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	propsys.h
Biblioteca	Propsys.lib
DLL	Propsys.dll (versão 5.0 ou posterior)
Redistribuível	Pesquisa da Área de Trabalho do Windows (WDS) 3.0