Función PSSetPropertyValue (propsys.h)

Establece el valor de una propiedad en un almacén de propiedades.

Sintaxis

PSSTDAPI PSSetPropertyValue(
  [in] IPropertyStore       *pps,
  [in] IPropertyDescription *ppd,
  [in] REFPROPVARIANT       propvar
);

Parámetros

[in] pps

Tipo: IPropertyStore*

Puntero a una instancia de la interfaz IPropertyStore , que representa el almacén de propiedades que contiene la propiedad .

[in] ppd

Tipo: IPropertyDescription*

Puntero a una instancia de la interfaz IPropertyDescription , que identifica la propiedad individual.

[in] propvar

Tipo: REFPROPVARIANT

Referencia a una estructura PROPVARIANT que contiene el nuevo valor.

Valor devuelto

Tipo: HRESULT

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Esta función auxiliar se usa para escribir un valor de propiedad en un almacén. Si el código de llamada ya tiene una estructura PROPERTYKEY , puede ser más sencillo llamar directamente a IPropertyStore::SetValue .

Ejemplos

En el ejemplo siguiente, para incluirse como parte de un programa más grande, se muestra cómo usar PSSetPropertyValue.

// IPropertyDescription *pPropDesc;
// IPropertyStore *pStore;
// PROPVARIANT propvar;
// Assume the variables pStore, pPropDesc, and propvar are initialized and valid.

HRESULT hr = PSSetPropertyValue(pStore, pPropDesc, propvar);

if (SUCCEEDED(hr))
{
    // The value has been written to the store but has not been committed yet.
}

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 6.0 o posterior)
Redistribuible	Windows Desktop Search (WDS) 3.0

Consulte también

IPropertyStore::Commit

PSGetPropertyValue