Fonction StgCreatePropStg (coml2api.h)

Article
08/22/2023

La fonction StgCreatePropStg crée et ouvre un jeu de propriétés dans un objet de stockage ou de flux spécifié. Le jeu de propriétés fournit l’implémentation autonome fournie par le système de l’interface IPropertyStorage .

Syntaxe

HRESULT StgCreatePropStg(
  [in]  IUnknown         *pUnk,
  [in]  REFFMTID         fmtid,
  [in]  const CLSID      *pclsid,
  [in]  DWORD            grfFlags,
  [in]  DWORD            dwReserved,
  [out] IPropertyStorage **ppPropStg
);

Paramètres

[in] pUnk

Pointeur vers l’interface IUnknown sur l’objet de stockage ou de flux qui stocke le nouvel ensemble de propriétés.

[in] fmtid

FMTID de la propriété définie à créer.

[in] pclsid

Pointeur vers le CLSID initial pour ce jeu de propriétés. Peut être NULL, auquel cas pclsid est défini sur tous les zéros.

[in] grfFlags

Valeurs des constantes PROPSETFLAG qui déterminent la façon dont le jeu de propriétés est créé et ouvert.

[in] dwReserved

Réservés au; doit être égal à zéro.

[out] ppPropStg

Adresse d’une variable de pointeur IPropertyStorage* qui reçoit le pointeur d’interface vers le nouveau jeu de propriétés.

Valeur retournée

Cette fonction prend en charge les valeurs de retour standard E_INVALIDARG et E_UNEXPECTED, en plus des éléments suivants :

Remarques

StgCreatePropStg crée et ouvre un nouveau jeu de propriétés qui fournit l’implémentation autonome fournie par le système de l’interface IPropertyStorage . Le nouveau jeu de propriétés est contenu dans l’objet de stockage ou de flux spécifié par pUnk. La valeur du paramètre grfFlags indique si pUnk spécifie un objet de stockage ou de flux. Par exemple, si PROPSETFLAG_NONSIMPLE est défini, pUnk peut être interrogé pour une interface IStorage sur un objet de stockage.

Dans les deux cas, cette fonction appelle pUnk-AddRef> pour l’objet de stockage ou de flux contenant le jeu de propriétés. Il incombe à l’appelant de libérer l’objet lorsqu’il n’est plus nécessaire.

Cette fonction est similaire à la méthode IPropertySetStorage ::Create . Toutefois, StgCreatePropStg ajoute le paramètre pUnk et prend en charge la valeur PROPSETFLAG_UNBUFFERED pour le paramètre grfFlags . Utilisez cette fonction au lieu de la méthode Create si vous avez une interface IStorage qui ne prend pas en charge l’interface IPropertySetStorage , ou si vous souhaitez utiliser la valeur PROPSETFLAG_UNBUFFERED. Pour plus d’informations sur l’utilisation de cette valeur d’énumération PROPSETFLAG_UNBUFFERED, consultez Constantes PROPSETFLAG.

Le jeu de propriétés contient automatiquement les propriétés de page de code et d’identificateur de paramètres régionaux (ID). Ceux-ci sont définis sur la valeur par défaut du système actuel et sur la valeur par défaut de l’utilisateur actuel, respectivement.

Le paramètre grfFlags est une combinaison de valeurs extraites des constantes PROPSETFLAG. La nouvelle valeur d’énumération PROPSETFLAG_UNBUFFERED est prise en charge. Pour plus d’informations, consultez Constantes PROPSETFLAG.

Cette fonction est exportée à partir du Iprop.dll redistribuable, qui est inclus dans Windows NT 4.0 avec Service Pack 2 (SP2) et versions ultérieures et disponible en tant que redistribuable dans Windows 95, Windows 98 et versions ultérieures. Dans Windows 2000 et Windows XP, il est exporté hors de ole32.dll. Il peut également être exporté hors iprop.dll dans Windows 2000 et Windows XP, mais l’appel est transféré à ole32.dll.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	coml2api.h (include Propidl.h)
Bibliothèque	Ole32.lib
DLL	Ole32.dll