Función StgCreatePropStg (coml2api.h)

Artículo
02/26/2024

La función StgCreatePropStg crea y abre una propiedad establecida en un objeto de secuencia o almacenamiento especificado. El conjunto de propiedades proporciona la implementación independiente proporcionada por el sistema de la interfaz IPropertyStorage .

Sintaxis

HRESULT StgCreatePropStg(
  [in]  IUnknown         *pUnk,
  [in]  REFFMTID         fmtid,
  [in]  const CLSID      *pclsid,
  [in]  DWORD            grfFlags,
  [in]  DWORD            dwReserved,
  [out] IPropertyStorage **ppPropStg
);

Parámetros

[in] pUnk

Puntero a la interfaz IUnknown en el objeto de almacenamiento o secuencia que almacena el nuevo conjunto de propiedades.

[in] fmtid

FMTID de la propiedad establecida en crearse.

[in] pclsid

Puntero al CLSID inicial de este conjunto de propiedades. Puede ser NULL, en cuyo caso pclsid se establece en todos los ceros.

[in] grfFlags

Los valores de las constantes PROPSETFLAG que determinan cómo se crea y abre el conjunto de propiedades.

[in] dwReserved

Reservados; debe ser cero.

[out] ppPropStg

Dirección de una variable de puntero IPropertyStorage* que recibe el puntero de interfaz al nuevo conjunto de propiedades.

Valor devuelto

Esta función admite los valores devueltos estándar E_INVALIDARG y E_UNEXPECTED, además de lo siguiente:

Comentarios

StgCreatePropStg crea y abre un nuevo conjunto de propiedades que proporciona la implementación independiente proporcionada por el sistema de la interfaz IPropertyStorage . El nuevo conjunto de propiedades está incluido en el objeto de almacenamiento o secuencia especificado por pUnk. El valor del parámetro grfFlags indica si pUnk especifica un objeto de almacenamiento o de flujo. Por ejemplo, si se establece PROPSETFLAG_NONSIMPLE, se puede consultar pUnk para obtener una interfaz IStorage en un objeto de almacenamiento.

En cualquier caso, esta función llama a pUnk-AddRef> para el objeto de almacenamiento o secuencia que contiene el conjunto de propiedades. Es responsabilidad del autor de la llamada liberar el objeto cuando ya no sea necesario.

Esta función es similar al método IPropertySetStorage::Create . Sin embargo, StgCreatePropStg agrega el parámetro pUnk y admite el valor de PROPSETFLAG_UNBUFFERED para el parámetro grfFlags . Use esta función en lugar del método Create si tiene una interfaz IStorage que no admite la interfaz IPropertySetStorage o si desea usar el valor de PROPSETFLAG_UNBUFFERED. Para obtener más información sobre el uso de este valor de enumeración PROPSETFLAG_UNBUFFERED, vea Constantes PROPSETFLAG.

El conjunto de propiedades contiene automáticamente las propiedades de la página de códigos y el identificador de configuración regional (ID). Se establecen en el valor predeterminado del sistema actual y el valor predeterminado del usuario actual, respectivamente.

El parámetro grfFlags es una combinación de valores tomados de constantes PROPSETFLAG. Se admite el nuevo valor de enumeración PROPSETFLAG_UNBUFFERED. Para obtener más información, vea Constantes PROPSETFLAG.

Esta función se exporta fuera del Iprop.dll redistribuible, que se incluye en Windows NT 4.0 con Service Pack 2 (SP2) y versiones posteriores y disponibles como redistribuibles en Windows 95, Windows 98 y versiones posteriores. En Windows 2000 y Windows XP, se exporta fuera de ole32.dll. También se puede exportar fuera de iprop.dll en Windows 2000 y Windows XP, pero la llamada se reenvía a ole32.dll.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows 2000 Server [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	coml2api.h (include Propidl.h)
Library	Ole32.lib
Archivo DLL	Ole32.dll