Função StgCreatePropStg (coml2api.h)

Artigo
08/22/2023

A função StgCreatePropStg cria e abre um conjunto de propriedades 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 StgCreatePropStg(
  [in]  IUnknown         *pUnk,
  [in]  REFFMTID         fmtid,
  [in]  const CLSID      *pclsid,
  [in]  DWORD            grfFlags,
  [in]  DWORD            dwReserved,
  [out] IPropertyStorage **ppPropStg
);

Parâmetros

[in] pUnk

Um ponteiro para a interface IUnknown no objeto de armazenamento ou fluxo que armazena o novo conjunto de propriedades.

[in] fmtid

O FMTID do conjunto de propriedades a ser criado.

[in] pclsid

Um Ponteiro para o CLSID inicial para esse conjunto de propriedades. Pode ser NULL; nesse caso , pclsid é definido como todos os zeros.

[in] grfFlags

Os valores das constantes PROPSETFLAG que determinam como o conjunto de propriedades é criado e aberto.

[in] dwReserved

Reservados; deve ser zero.

[out] ppPropStg

O endereço de uma variável de ponteiro IPropertyStorage* que recebe o ponteiro de interface para o novo conjunto de propriedades.

Retornar valor

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

Comentários

StgCreatePropStg cria e abre um novo conjunto de propriedades que fornece a implementação autônoma fornecida pelo sistema da interface IPropertyStorage . O novo conjunto de propriedades 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. É responsabilidade do chamador liberar o objeto quando ele não for mais necessário.

Essa função é semelhante ao método IPropertySetStorage::Create . No entanto, StgCreatePropStg adiciona o parâmetro pUnk e dá suporte ao valor PROPSETFLAG_UNBUFFERED para o parâmetro grfFlags . Use essa função em vez do método Create 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 esse valor de enumeração PROPSETFLAG_UNBUFFERED, consulte Constantes PROPSETFLAG.

O conjunto de propriedades contém automaticamente propriedades de ID (identificador de localidade) e página de código. Eles são definidos como o padrão do sistema atual e o padrão do usuário atual, respectivamente.

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 para fora do Iprop.dll redistribuível, que está incluído no Windows NT 4.0 com Service Pack 2 (SP2) e posterior e disponível como um redistribuível no Windows 95, Windows 98 e posterior. No Windows 2000 e no Windows XP, ele é exportado de ole32.dll. Ele também pode ser exportado de iprop.dll no Windows 2000 e no Windows XP, 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