función PSPropertyBag_WritePropertyKey (propsys.h)

Establece el valor de clave de propiedad de una propiedad en un contenedor de propiedades.

Sintaxis

PSSTDAPI PSPropertyBag_WritePropertyKey(
  [in] IPropertyBag   *propBag,
  [in] LPCWSTR        propName,
  [in] REFPROPERTYKEY value
);

Parámetros

[in] propBag

Tipo: IPropertyBag*

Puntero a un objeto IPropertyBag que representa el contenedor de propiedades en el que se almacena la propiedad.

[in] propName

Tipo: LPCWSTR

Cadena de nombre de propiedad terminada en null.

[in] value

Tipo: REFPROPERTYKEY

Estructura PROPERTYKEY que especifica el valor de clave de propiedad que se va a almacenar en la propiedad .

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

Las claves de propiedad identifican de forma única una propiedad. Por ejemplo, PKEY_Keywords corresponde a System.Keywords. Esta función solo se realiza correctamente para las propiedades registradas como parte del esquema de propiedades.

La API de función de propiedad del contenedor de propiedades convierte entre los tipos de ventana y el tipo VARIANT que se usa para expresar valores en un contenedor de propiedades. Al hacerlo, se facilita el uso del contenedor de propiedades, se simplifican las aplicaciones y se evitan errores comunes de codificación.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	propsys.h
Library	Propsys.lib
Archivo DLL	Propsys.dll (versión 6.0 o posterior)

Consulte también

PSPropertyBag_ReadPropertyKey