Função StgOpenPropStg (coml2api.h)

Artigo
02/24/2024

A função StgOpenPropStg abre um conjunto de propriedades especificado em um objeto de fluxo ou armazenamento especificado. O conjunto de propriedades fornece a implementação autônoma fornecida pelo sistema da interface IPropertyStorage .

Sintaxe

HRESULT StgOpenPropStg(
  [in]  IUnknown         *pUnk,
  [in]  REFFMTID         fmtid,
  [in]  DWORD            grfFlags,
  [in]  DWORD            dwReserved,
  [out] IPropertyStorage **ppPropStg
);

Parâmetros

[in] pUnk

O ponteiro de interface para a interface IUnknown no objeto de armazenamento ou fluxo que contém o objeto de conjunto de propriedades solicitado.

[in] fmtid

O FMTID do conjunto de propriedades a ser aberto.

[in] grfFlags

Os valores das constantes PROPSETFLAG.

[in] dwReserved

Reservado para uso futuro; deve ser zero.

[out] ppPropStg

Um ponteiro para uma variável de ponteiro IPropertyStorage* que recebe o ponteiro de interface para o conjunto de propriedades solicitado.

Retornar valor

Essa função dá suporte aos valores retornados padrão E_INVALIDARG e E_UNEXPECTED, além dos seguintes:

Comentários

StgOpenPropStg abre o conjunto de propriedades solicitado e fornece a implementação autônoma fornecida pelo sistema da interface IPropertyStorage . O conjunto de propriedades solicitado está contido no objeto de armazenamento ou fluxo especificado por pUnk. O valor do parâmetro grfFlags indica se pUnk especifica um objeto de armazenamento ou fluxo. Por exemplo, se PROPSETFLAG_NONSIMPLE estiver definido, pUnk poderá ser consultado para uma interface IStorage em um objeto de armazenamento.

Em ambos os casos, essa função chama pUnk-AddRef> para o objeto de armazenamento ou fluxo que contém o conjunto de propriedades. O chamador deve liberar o objeto quando não for mais necessário.

Essa função é semelhante ao método IPropertySetStorage::Open . No entanto, StgOpenPropStg adiciona os parâmetros pUnk e grfFlags , incluindo o valor PROPSETFLAG_UNBUFFERED para o parâmetro grfFlags . Use essa função em vez do método Open se você tiver uma interface IStorage que não dê suporte à interface IPropertySetStorage ou se quiser usar o valor PROPSETFLAG_UNBUFFERED. Para obter mais informações sobre como usar PROPSETFLAG_UNBUFFERED, consulte Constantes PROPSETFLAG.

O parâmetro grfFlags é uma combinação de valores obtidos de constantes PROPSETFLAG. Há suporte para o novo valor de enumeração PROPSETFLAG_UNBUFFERED. Para obter mais informações, consulte Constantes PROPSETFLAG.

Essa função é exportada do iprop.dll redistribuível, que está incluído no Windows NT 4.0 com Service Pack 2 (SP2) e disponível como um redistribuível no Windows 95 e posterior. No Windows 2000, ele é exportado para fora do Ole32.dll. Ele também pode ser exportado de iprop.dll no Windows 2000, mas a chamada é encaminhada para ole32.dll.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows 2000 Server [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	coml2api.h (inclua Propidl.h)
Biblioteca	Ole32.lib
DLL	Ole32.dll