Partager via


ReadFmtUserTypeStg, fonction (ole2.h)

La fonction ReadFmtUserTypeStg renvoie le format du Presse-papiers et le type d’utilisateur précédemment enregistrés avec la fonction WriteFmtUserTypeStg .

Syntaxe

HRESULT ReadFmtUserTypeStg(
  [in]  LPSTORAGE  pstg,
  [out] CLIPFORMAT *pcf,
  [out] LPOLESTR   *lplpszUserType
);

Paramètres

[in] pstg

Pointeur vers l’interface IStorage sur l’objet de stockage à partir duquel les informations doivent être lues.

[out] pcf

Pointeur vers l’emplacement où le format du Presse-papiers doit être écrit au retour. Il peut être NULL, ce qui indique que le format n’intéresse pas l’appelant.

[out] lplpszUserType

Adresse de la variable pointeur LPWSTR qui reçoit un pointeur vers la chaîne de type utilisateur Unicode terminée par null. L’appelant peut spécifier NULL pour ce paramètre, ce qui indique que le type d’utilisateur n’a aucun intérêt. Cette fonction alloue de la mémoire pour la chaîne. L’appelant est chargé de libérer la mémoire avec CoTaskMemFree.

Valeur retournée

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

Cette fonction retourne également l’une des valeurs d’erreur retournées par la méthode ISequentialStream ::Read .

Remarques

ReadFmtUserTypeStg renvoie le format du Presse-papiers et la chaîne de type utilisateur de l’objet de stockage spécifié. La fonction WriteClassStg doit avoir été appelée avant d’appeler 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

Voir aussi

CoTaskMemFree

WriteFmtUserTypeStg