Función PSGetPropertyValue (propsys.h)

Obtiene un valor de propiedad de un almacén de propiedades.

Sintaxis

PSSTDAPI PSGetPropertyValue(
  [in]  IPropertyStore       *pps,
  [in]  IPropertyDescription *ppd,
  [out] PROPVARIANT          *ppropvar
);

Parámetros

[in] pps

Tipo: IPropertyStore*

Puntero a una instancia de la interfaz IPropertyStore , que representa el almacén de propiedades desde el que se va a obtener el valor.

[in] ppd

Tipo: IPropertyDescription*

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

[out] ppropvar

Tipo: PROPVARIANT*

Puntero a una estructura PROPVARIANT sin inicializar. Cuando esta función devuelve, apunta al valor de propiedad solicitado.

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 leer un valor de propiedad de un almacén. Si el código de llamada ya tiene una estructura PROPERTYKEY , puede ser más sencillo llamar directamente a IPropertyStore::GetValue .

Ejemplos

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

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

HRESULT hr = PSGetPropertyValue(pStore, pPropDesc, &propvar);

if (SUCCEEDED(hr))
{
    // propvar is valid.
 
    PropVariantClear(&propvar);
}

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	Búsqueda de escritorio de Windows (WDS) 3.0

Consulte también

PSSetPropertyValue