OleCreateFromFile, fonction (ole2.h)

Crée un objet incorporé à partir du contenu d’un fichier nommé.

Syntaxe

HRESULT OleCreateFromFile(
  [in]  REFCLSID        rclsid,
  [in]  LPCOLESTR       lpszFileName,
  [in]  REFIID          riid,
  [in]  DWORD           renderopt,
  [in]  LPFORMATETC     lpFormatEtc,
  [in]  LPOLECLIENTSITE pClientSite,
  [in]  LPSTORAGE       pStg,
  [out] LPVOID          *ppvObj
);

Paramètres

[in] rclsid

Ce paramètre est réservé et doit être CLSID_NULL.

[in] lpszFileName

Pointeur vers une chaîne spécifiant le chemin complet du fichier à partir duquel l’objet doit être initialisé.

[in] riid

Référence à l’identificateur de l’interface que l’appelant utilisera ultérieurement pour communiquer avec le nouvel objet (généralement IID_IOleObject, défini dans les en-têtes OLE comme ID d’interface d’IOleObject).

[in] renderopt

Valeur de l’énumération OLERENDER qui indique les fonctionnalités de dessin ou de récupération de données mises en cache localement que l’objet nouvellement créé doit avoir. La valeur OLERENDER choisie affecte les valeurs possibles pour le paramètre lpFormatEtc .

[in] lpFormatEtc

Selon les indicateurs OLERENDER utilisés comme valeur de renderopt, pointeur vers l’une des valeurs d’énumération FORMATETC . Reportez-vous également à l’énumération OLERENDER pour connaître les restrictions.

[in] pClientSite

Pointeur vers un instance de IOleClientSite, l’interface principale via laquelle l’objet demande des services à partir de son conteneur. Ce paramètre peut être NULL.

[in] pStg

Pointeur vers l’interface IStorage sur l’objet de stockage. Ce paramètre ne peut pas être NULL.

[out] ppvObj

Adresse de la variable pointeur qui reçoit le pointeur d’interface demandé dans riid. En cas de retour réussi, *ppvObj contient le pointeur d’interface demandé sur l’objet nouvellement créé.

Valeur retournée

Cette fonction retourne S_OK en cas de réussite. Les autres valeurs possibles sont les suivantes.

Remarques

La fonction OleCreateFromFile crée un objet incorporé à partir du contenu d’un fichier nommé. Si le ProgID dans la base de données d’inscription contient la clé PackageOnFileDrop, il crée un package. Si ce n’est pas le cas, la fonction appelle la fonction GetClassFile pour obtenir le CLSID associé au paramètre lpszFileName , puis crée un objet incorporé OLE 2 associé à ce CLSID. Le paramètre rclsidd’OleCreateFromFile est toujours ignoré et doit être défini sur CLSID_NULL.

Comme pour les autres fonctions OleCreateXxx, l’objet nouvellement créé n’est pas présenté à l’utilisateur pour modification, ce qui nécessite une opération DoVerb . Il est utilisé pour implémenter des opérations d’insertion de fichier.

Configuration requise

Voir aussi

GetClassFile