PSPropertyBag_ReadStrAlloc función (propsys.h)

Lee un valor de datos de cadena de una propiedad de un contenedor de propiedades y asigna memoria para la cadena que se lee.

Sintaxis

PSSTDAPI PSPropertyBag_ReadStrAlloc(
  [in]  IPropertyBag *propBag,
  [in]  LPCWSTR      propName,
  [out] PWSTR        *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

Puntero a una cadena de nombre de propiedad terminada en null.

[out] value

Tipo: PWSTR*

Cuando esta función vuelve, contiene un puntero a un valor de datos de cadena de una propiedad de un contenedor de propiedades y asigna memoria para la cadena que se lee. El autor de la llamada de la función PSPropertyBag_ReadStrAlloc debe llamar a una función CoTaskMemFree en este parámetro.

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)