Función SHPropStgCreate (shlobj_core.h)

[Esta función está disponible a través de Windows XP Service Pack 2 (SP2) y Windows Server 2003. Es posible que se modifique o no esté disponible en versiones posteriores de Windows.

Garantiza el control adecuado de la recuperación o asignación de páginas de códigos para la operación de conjunto de propiedades solicitada.

Sintaxis

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*

Puntero a una interfaz IPropertySetStorage .

[in] fmtid

Tipo: REFFMTID

Un identificador de conjunto de propiedades que se va a abrir. Los valores de este parámetro pueden ser uno de los definidos en Identificadores de formato de conjunto de propiedades predefinidos o cualquier otro FMTID que registre.

[in, optional] pclsid

Tipo: const CLSID*

Puntero al CLSID asociado al conjunto. Este parámetro puede ser NULL.

grfFlags

Tipo: DWORD

Uno o varios miembros de la enumeración PROPSETFLAG que determinan cómo se crea y abre el conjunto de propiedades. Todos los conjuntos que contienen bytes ANSI deben crearse con PROPSETFLAG_ANSI; de lo contrario, PROPSETFLAG_DEFAULT.

grfMode

Tipo: DWORD

Marcas de la enumeración STGM que indican condiciones para crear y eliminar el objeto y los modos de acceso para el objeto. Debe contener STGM_DIRECT | STGM_SHARE_EXCLUSIVE.

dwDisposition

Tipo: DWORD

Uno de los valores siguientes, definidos en Fileapi.h.

CREATE_NEW (1)

Cree un nuevo conjunto si aún no existe uno.

CREATE_ALWAYS (2)

Cree siempre un nuevo conjunto, sobrescribiendo cualquier conjunto existente.

OPEN_EXISTING (3)

Abra el conjunto existente.

OPEN_ALWAYS (4)

[out] ppstg

Tipo: IPropertyStorage**

Cuando este método devuelve, contiene un puntero de interfaz IPropertyStorage .

[out, optional] puCodePage

Tipo: UINT*

Cuando este método devuelve , contiene la dirección del identificador de la página de códigos del conjunto.

Valor devuelto

Tipo: HRESULT

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shlobj_core.h
Library	Shell32.lib
Archivo DLL	Shell32.dll (versión 6.0 o posterior)