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