Método IPropertySetStorage::Create (propidl.h)

Artigo
08/25/2023

O método Create cria e abre um novo conjunto de propriedades no objeto de armazenamento do conjunto de propriedades.

Sintaxe

HRESULT Create(
  [in]  REFFMTID         rfmtid,
  [in]  const CLSID      *pclsid,
  [in]  DWORD            grfFlags,
  [in]  DWORD            grfMode,
  [out] IPropertyStorage **ppprstg
);

Parâmetros

[in] rfmtid

O FMTID do conjunto de propriedades a ser criado. Para obter informações sobre FMTIDs conhecidos e predefinidos no SDK da Plataforma, consulte Identificadores de formato predefinidos do conjunto de propriedades.

[in] pclsid

Um ponteiro para o CLSID do identificador de classe inicial para esse conjunto de propriedades. Pode ser NULL; nesse caso, ele é definido como todos os zeros. O CLSID é o CLSID de uma classe que exibe e/ou fornece acesso programático aos valores de propriedade. Se não houver essa classe, é recomendável que o FMTID seja usado.

[in] grfFlags

Os valores das constantes PROPSETFLAG.

[in] grfMode

Um modo de acesso no qual o conjunto de propriedades recém-criado deve ser aberto, obtido de determinados valores de STGM_Constants, conforme descrito na seção Comentários a seguir.

[out] ppprstg

Um ponteiro para a variável de saída que recebe o ponteiro da interface IPropertyStorage .

Retornar valor

Esse método dá suporte ao valor retornado padrão E_UNEXPECTED, bem como ao seguinte:

Comentários

IPropertySetStorage::Create cria e abre um novo subobjeto de conjunto de propriedades (que dá suporte à interface IPropertyStorage ) contido neste objeto de armazenamento do conjunto de propriedades. O conjunto de propriedades contém automaticamente propriedades de ID de localidade e página de código. Eles são definidos como o Unicode e o padrão do usuário atual, respectivamente.

O parâmetro grfFlags é uma combinação de valores obtidos de constantes PROPSETFLAG. Se o valor PROPSETFLAG_ANSI dessa enumeração for usado, a página de código será definida como o padrão do sistema atual, em vez de Unicode.

O parâmetro grfMode especifica o modo de acesso no qual o conjunto recém-criado deve ser aberto. Os valores para esse parâmetro são como no parâmetro grfMode para IPropertySetStorage::Open, com a adição dos valores listados na tabela a seguir.

Valor	Significado
STGM_FAILIFTHERE	Se houver outra propriedade definida com o parâmetro fmtid especificado, a chamada falhará. Essa é a ação padrão; ou seja, a menos que STGM_CREATE seja especificado, STGM_FAILIFTHERE está implícito.
STGM_CREATE	Se outro conjunto de propriedades com o parâmetro fmtid especificado já existir, ele será removido e substituído por este novo.

O conjunto de propriedades criado é simples por padrão, mas o chamador pode solicitar um conjunto de propriedades não simples especificando o valor PROPSETFLAG_NONSIMPLE no parâmetro grfFlags . Para obter mais informações sobre conjuntos de propriedades simples e não simples, consulte Armazenamento e objetos Stream para um conjunto de propriedades.

Esse método está sujeito às restrições do IStorage::CreateStream subjacente (para conjuntos de propriedades simples) ou IStorage::CreateStorage (para conjuntos de propriedades não simples). Por exemplo, ao usar a Implementação de Arquivo Composto IPropertySetStorage, especifique STGM_SHARE_EXCLUSIVE no parâmetro grfMode para IPropertySetStorage::Create. Por outro lado, se estiver usando a implementação autônoma IPropertySetStorage, IPropertySetStorage::Create estará sujeito a restrições que se aplicam ao IStorage especificado pelo chamador.

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	propidl.h (inclua Objbase.h)
Biblioteca	Uuid.lib
DLL	Ole32.dll