WriteFmtUserTypeStg, fonction (ole2.h)
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) |