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 |