Fonction StgOpenPropStg (coml2api.h)

Article
08/22/2023

La fonction StgOpenPropStg ouvre un jeu de propriétés spécifié 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 StgOpenPropStg(
  [in]  IUnknown         *pUnk,
  [in]  REFFMTID         fmtid,
  [in]  DWORD            grfFlags,
  [in]  DWORD            dwReserved,
  [out] IPropertyStorage **ppPropStg
);

Paramètres

[in] pUnk

Pointeur d’interface pour l’interface IUnknown sur l’objet de stockage ou de flux qui contient l’objet de jeu de propriétés demandé.

[in] fmtid

FMTID de la propriété définie pour être ouverte.

[in] grfFlags

Valeurs des constantes PROPSETFLAG.

[in] dwReserved

Réservé pour une future utilisation ; doit être nul.

[out] ppPropStg

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

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

StgOpenPropStg ouvre le jeu de propriétés demandé et fournit l’implémentation autonome fournie par le système de l’interface IPropertyStorage . Le jeu de propriétés demandé 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. L’appelant doit libérer l’objet lorsqu’il n’est plus nécessaire.

Cette fonction est similaire à la méthode IPropertySetStorage ::Open . Toutefois, StgOpenPropStg ajoute les paramètres pUnk et grfFlags , y compris la valeur PROPSETFLAG_UNBUFFERED pour le paramètre grfFlags . Utilisez cette fonction au lieu de la méthode Open 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 PROPSETFLAG_UNBUFFERED, consultez Constantes PROPSETFLAG.

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 hors du iprop.dll redistribuable, qui est inclus dans Windows NT 4.0 avec Service Pack 2 (SP2) et disponible en tant que redistribuable dans Windows 95 et versions ultérieures. Dans Windows 2000, il est exporté à partir de Ole32.dll. Il peut également être exporté hors iprop.dll dans Windows 2000, mais l’appel est transféré vers 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