Función StgOpenPropStg (coml2api.h)

Artículo
08/22/2023

La función StgOpenPropStg abre un conjunto de propiedades especificado 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 StgOpenPropStg(
  [in]  IUnknown         *pUnk,
  [in]  REFFMTID         fmtid,
  [in]  DWORD            grfFlags,
  [in]  DWORD            dwReserved,
  [out] IPropertyStorage **ppPropStg
);

Parámetros

[in] pUnk

Puntero de interfaz para la interfaz IUnknown en el objeto de flujo o almacenamiento que contiene el objeto de conjunto de propiedades solicitado.

[in] fmtid

FMTID del conjunto de propiedades que se va a abrir.

[in] grfFlags

Valores de constantes PROPSETFLAG.

[in] dwReserved

Reservado para uso futuro; debe ser cero.

[out] ppPropStg

Puntero a una variable de puntero IPropertyStorage* que recibe el puntero de interfaz al conjunto de propiedades solicitado.

Valor devuelto

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

Comentarios

StgOpenPropStg abre el conjunto de propiedades solicitado y proporciona la implementación independiente proporcionada por el sistema de la interfaz IPropertyStorage . El conjunto de propiedades solicitado se encuentra en el objeto de almacenamiento o secuencia especificado por pUnk. El valor del parámetro grfFlags indica si pUnk especifica un objeto de flujo o almacenamiento. 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. El autor de la llamada debe liberar el objeto cuando ya no sea necesario.

Esta función es similar al método IPropertySetStorage::Open . Sin embargo, StgOpenPropStg agrega los parámetros pUnk y grfFlags , incluido el valor de PROPSETFLAG_UNBUFFERED para el parámetro grfFlags . Use esta función en lugar del método Open 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 PROPSETFLAG_UNBUFFERED, vea Constantes PROPSETFLAG.

El parámetro grfFlags es una combinación de valores tomados de las 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 está disponible como redistribuible en Windows 95 y versiones posteriores. En Windows 2000, se exporta fuera de Ole32.dll. También se puede exportar fuera de iprop.dll en Windows 2000, 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