Partager via

WriteFmtUserTypeStg, fonction (ole2.h)

  • Article

La fonction WriteFmtUserTypeStg écrit un format de Presse-papiers et un type d’utilisateur dans l’objet de stockage.

Syntaxe

HRESULT WriteFmtUserTypeStg(
  [in] LPSTORAGE  pstg,
  [in] CLIPFORMAT cf,
  [in] LPOLESTR   lpszUserType
);

Paramètres

[in] pstg

Pointeur IStorage vers l’objet de stockage dans lequel les informations doivent être écrites.

[in] cf

Spécifie le format du Presse-papiers qui décrit la structure de la zone native de l’objet de stockage. La balise de format inclut la stratégie pour les noms des flux et sous-stockages au sein de cet objet de stockage, ainsi que les règles d’interprétation des données dans ces flux.

[in] lpszUserType

Pointeur vers une chaîne Unicode terminée par null qui spécifie le type d’utilisateur actuel de l’objet. La valeur de type utilisateur, elle-même, ne peut pas être NULL. Il s’agit du type retourné par la méthode IOleObject ::GetUserType . Si cette fonction est transférée vers un ordinateur distant où la classe d’objet n’existe pas, ce type d’utilisateur stocké de manière permanente peut être affiché à l’utilisateur dans les boîtes de dialogue.

Valeur retournée

Cette fonction retourne HRESULT.

Remarques

La fonction WriteFmtUserTypeStg doit être appelée dans l’implémentation d’un objet de la méthode IPersistStorage ::Save . Il doit également être appelé par les objets au niveau du document qui utilisent le stockage structuré pour leur représentation persistante dans leur séquence d’enregistrement.

Pour lire les informations enregistrées, les applications appellent la fonction ReadFmtUserTypeStg .

Configuration requise

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 ole2.h
Bibliothèque Ole32.lib
DLL Ole32.dll
Ensemble d’API ext-ms-win-com-ole32-l1-1-3 (introduit dans Windows 10, version 10.0.10240)

Voir aussi

IPersistStorage ::Save

ReadFmtUserTypeStg