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

Artigo
03/05/2024

O método Open abre um conjunto de propriedades contido no objeto de armazenamento do conjunto de propriedades.

Sintaxe

HRESULT Open(
  [in]  REFFMTID         rfmtid,
  [in]  DWORD            grfMode,
  [out] IPropertyStorage **ppprstg
);

Parâmetros

[in] rfmtid

O FMTID (identificador de formato) da propriedade definida para ser aberta. Para obter mais informações sobre FMTIDs conhecidos e predefinidos no SDK da Plataforma, consulte Identificadores de formato predefinidos do conjunto de propriedades.

[in] grfMode

O modo de acesso no qual o conjunto de propriedades recém-criado deve ser aberto. Esses sinalizadores são retirados das constantes STGM. Os sinalizadores que podem ser usados e seus significados no contexto desse método são descritos na seção Comentários a seguir.

[out] ppprstg

Um ponteiro para a variável de ponteiro IPropertyStorage que recebe o ponteiro de interface para o subobjeto de armazenamento de propriedades solicitado.

Retornar valor

Esse método dá suporte ao valor de retorno padrão E_UNEXPECTED, além do seguinte:

Comentários

O modo no qual o conjunto de propriedades deve ser aberto é especificado no parâmetro grfMode. Esses sinalizadores são retirados de constantes STGM, mas, para esse método, os valores legais e seus significados são os seguintes (apenas determinadas combinações desses valores de sinalizador são legais).

Valor	Significado
STGM_DIRECT	Abre o conjunto de propriedades sem um nível adicional de aninhamento de transações. Esse é o padrão (o comportamento se nem STGM_DIRECT nem STGM_TRANSACTED for especificado).
STGM_TRANSACTED	Abre o conjunto de propriedades com um nível adicional de aninhamento de transações (além da transação, se houver, nesse objeto de armazenamento do conjunto de propriedades). O modo transacionado está disponível apenas para conjuntos de propriedades não simplificados. As alterações no conjunto de propriedades devem ser confirmadas com uma chamada para IPropertyStorage::Commit antes de ficarem visíveis para a transação neste armazenamento do conjunto de propriedades.
STGM_READ	Abre o conjunto de propriedades com acesso de leitura. A permissão de leitura é necessária no armazenamento do conjunto de propriedades.
STGM_WRITE	Abre o conjunto de propriedades com acesso de gravação. Nem todas as implementações do IPropertyStorage dão suporte a esse modo.
STGM_READWRITE	Abre o conjunto de propriedades com acesso de leitura e gravação. Lembre-se de que esse sinalizador não é o OR binário dos valores STGM_READ e STGM_WRITE.
STGM_SHARE_DENY_NONE	As aberturas subsequentes do conjunto de propriedades desse armazenamento do conjunto de propriedades não são negadas ao acesso de leitura ou gravação. (Não disponível em todas as implementações.)
STGM_SHARE_DENY_READ	As aberturas subsequentes do conjunto de propriedades desse armazenamento do conjunto de propriedades são negadas ao acesso de leitura. Não disponível em todas as implementações.
STGM_SHARE_DENY_WRITE	As aberturas subsequentes do conjunto de propriedades desse armazenamento do conjunto de propriedades são negadas ao acesso de gravação. Esse valor normalmente é usado no modo transacionado para evitar fazer cópias desnecessárias de um objeto aberto por vários usuários. Ou seja, se STGM_TRANSACTED for especificado, mas esse valor não for especificado, um instantâneo será feito, quer haja aberturas subsequentes ou não. Assim, você pode melhorar o desempenho especificando esse valor. Não disponível em todas as implementações.
STGM_SHARE_EXCLUSIVE	As aberturas subsequentes do conjunto de propriedades desse armazenamento do conjunto de propriedades não são possíveis. Lembre-se de que esse valor não é um OR binário simples dos elementos STGM_SHARE_DENY_READ e STGM_SHARE_DENY_WRITE.

Esse método está sujeito às restrições do IStorage::OpenStream subjacente (para conjuntos de propriedades simples) ou IStorage::OpenStorage (para conjuntos de propriedades não simples). Para obter mais informações sobre conjuntos de propriedades simples e não simples, consulte Armazenamento e objetos Stream para um conjunto de propriedades. Por exemplo, ao usar a Implementação de Arquivo Composto IPropertySetStorage, você deve especificar STGM_SHARE_EXCLUSIVE no parâmetro grfMode para IPropertySetStorage::Open. Por outro lado, se estiver usando a Implementação autônoma IPropertySetStorage, IPropertySetStorage::Open 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