Funzione PSSetPropertyValue (propsys.h)

Articolo
03/15/2023

Imposta il valore di una proprietà in un archivio delle proprietà.

Sintassi

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

Parametri

[in] pps

Tipo: IPropertyStore*

Puntatore a un'istanza dell'interfaccia IPropertyStore , che rappresenta l'archivio delle proprietà che contiene la proprietà .

[in] ppd

Tipo: IPropertyDescription*

Puntatore a un'istanza dell'interfaccia IPropertyDescription , che identifica la singola proprietà.

[in] propvar

Tipo: REFPROPVARIANT

Riferimento a una struttura PROPVARIANT che contiene il nuovo valore.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questa funzione helper viene usata per scrivere un valore di proprietà in un archivio. Se il codice chiamante ha già una struttura PROPERTYKEY , potrebbe essere più semplice chiamare direttamente IPropertyStore::SetValue .

Esempio

Nell'esempio seguente, da includere come parte di un programma più ampio, viene illustrato come usare 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.
}

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP con SP2, Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 con SP1 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	propsys.h
Libreria	Propsys.lib
DLL	Propsys.dll (versione 6.0 o successiva)
Componente ridistribuibile	Windows Desktop Search (WDS) 3.0

Vedi anche

IPropertyStore::Commit

PSGetPropertyValue

Condividi tramite