Fonction SHPropStgCreate (shlobj_core.h)

[Cette fonction est disponible via Windows XP Service Pack 2 (SP2) et Windows Server 2003. Il peut être modifié ou indisponible dans les versions ultérieures de Windows.]

Garantit une gestion correcte de la récupération ou de l’affectation des pages de codes pour l’opération de jeu de propriétés demandée.

Syntaxe

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
);

Paramètres

[in] psstg

Type : IPropertySetStorage*

Pointeur vers une interface IPropertySetStorage .

[in] fmtid

Type : REFFMTID

ID de jeu de propriétés à ouvrir. Les valeurs de ce paramètre peuvent être l’une de celles définies dans identificateurs de format d’ensemble de propriétés prédéfinis ou tout autre FMTID que vous inscrivez.

[in, optional] pclsid

Type : const CLSID*

Pointeur vers le CLSID associé à l’ensemble. Ce paramètre peut être NULL.

grfFlags

Type : DWORD

Un ou plusieurs membres de l’énumération PROPSETFLAG qui déterminent comment le jeu de propriétés est créé et ouvert. Tous les jeux contenant des octets ANSI doivent être créés avec PROPSETFLAG_ANSI, sinon PROPSETFLAG_DEFAULT.

grfMode

Type : DWORD

Indicateurs de l’énumération STGM qui indiquent les conditions de création et de suppression de l’objet et des modes d’accès pour l’objet. Doit contenir STGM_DIRECT | STGM_SHARE_EXCLUSIVE.

dwDisposition

Type : DWORD

L’une des valeurs suivantes, définie dans Fileapi.h.

CREATE_NEW (1)

Créez un jeu s’il n’en existe pas déjà un.

CREATE_ALWAYS (2)

Créez toujours un ensemble, en remplaçant tout jeu existant.

OPEN_EXISTING (3)

Ouvrez l’ensemble existant.

OPEN_ALWAYS (4)

[out] ppstg

Type : IPropertyStorage**

Lorsque cette méthode est retournée, contient un pointeur d’interface IPropertyStorage .

[out, optional] puCodePage

Type : UINT*

Lorsque cette méthode est retournée, contient l’adresse de l’ID de page de codes pour l’ensemble.

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlobj_core.h
Bibliothèque	Shell32.lib
DLL	Shell32.dll (version 6.0 ou ultérieure)