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 |