Compartir a través de


PSPropertyBag_ReadStr función (propsys.h)

Lee el valor de datos de cadena de una propiedad en un contenedor de propiedades.

Sintaxis

PSSTDAPI PSPropertyBag_ReadStr(
  [in]  IPropertyBag *propBag,
  [in]  LPCWSTR      propName,
  [out] LPWSTR       value,
  [out] int          characterCount
);

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.

[out] value

Tipo: LPCWSTR

Cuando se devuelve esta función, contiene un puntero a un valor de propiedad de cadena.

[out] characterCount

Tipo: int

Esta función devuelve el entero que representa el tamaño (número máximo de caracteres) del parámetro de valor que se devuelve.

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

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

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_WriteStr