Compartilhar via

Função SHPropStgCreate (shlobj_core.h)

  • Artigo

[Essa função está disponível por meio do Windows XP Service Pack 2 (SP2) e do Windows Server 2003. Ele pode estar alterado ou indisponível em versões subsequentes do Windows.]

Garante o tratamento adequado da recuperação ou atribuição da página de código para a operação de conjunto de propriedades solicitada.

Sintaxe

SHSTDAPI SHPropStgCreate(
  [in]            IPropertySetStorage *psstg,
  [in]            REFFMTID            fmtid,
  [in, optional]  const CLSID         *pclsid,
                  DWORD               grfFlags,
                  DWORD               grfMode,
                  DWORD               dwDisposition,
  [out]           IPropertyStorage    **ppstg,
  [out, optional] UINT                *puCodePage
);

Parâmetros

[in] psstg

Tipo: IPropertySetStorage*

Um ponteiro para uma interface IPropertySetStorage .

[in] fmtid

Tipo: REFFMTID

Uma ID do conjunto de propriedades a ser aberta. Os valores para esse parâmetro podem ser um dos definidos em Identificadores de Formato predefinidos do conjunto de propriedades ou qualquer outro FMTID que você registrar.

[in, optional] pclsid

Tipo: const CLSID*

Um ponteiro para o CLSID associado ao conjunto. Este parâmetro pode ser NULL.

grfFlags

Tipo: DWORD

Um ou mais membros da enumeração PROPSETFLAG que determinam como o conjunto de propriedades é criado e aberto. Todos os conjuntos que contêm bytes ANSI devem ser criados com PROPSETFLAG_ANSI, caso contrário, PROPSETFLAG_DEFAULT.

grfMode

Tipo: DWORD

Os sinalizadores da enumeração STGM que indicam condições para criar e excluir o objeto e os modos de acesso para o objeto. Deve conter STGM_DIRECT | STGM_SHARE_EXCLUSIVE.

dwDisposition

Tipo: DWORD

Um dos valores a seguir, definidos em Fileapi.h.

CREATE_NEW (1)

Crie um novo conjunto se ainda não existir um.

CREATE_ALWAYS (2)

Sempre crie um novo conjunto, substituindo qualquer conjunto existente.

OPEN_EXISTING (3)

Abra o conjunto existente.

OPEN_ALWAYS (4)

[out] ppstg

Tipo: IPropertyStorage**

Quando esse método retorna, contém um ponteiro de interface IPropertyStorage .

[out, optional] puCodePage

Tipo: UINT*

Quando esse método retorna, contém o endereço da ID da página de código para o conjunto.

Retornar valor

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shlobj_core.h
Biblioteca Shell32.lib
DLL Shell32.dll (versão 6.0 ou posterior)