Funzione OleCreateFromFile (ole2.h)

Crea un oggetto incorporato dal contenuto di un file denominato.

Sintassi

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
);

Parametri

[in] rclsid

Questo parametro è riservato e deve essere CLSID_NULL.

[in] lpszFileName

Puntatore a una stringa che specifica il percorso completo del file da cui deve essere inizializzato l'oggetto.

[in] riid

Riferimento all'identificatore dell'interfaccia che il chiamante usa in seguito per comunicare con il nuovo oggetto (in genere IID_IOleObject, definito nelle intestazioni OLE come ID interfaccia di IOleObject).

[in] renderopt

Valore dell'enumerazione OLERENDER che indica le funzionalità di disegno o recupero dati memorizzate nella cache locale che l'oggetto appena creato deve avere. Il valore OLERENDER scelto influisce sui valori possibili per il parametro lpFormatEtc .

[in] lpFormatEtc

A seconda di quale flag OLERENDER viene usato come valore di rendering, puntatore a uno dei valori di enumerazione FORMATETC . Per le restrizioni, vedere anche l'enumerazione OLERENDER .

[in] pClientSite

Puntatore a un'istanza di IOleClientSite, l'interfaccia primaria tramite cui l'oggetto richiederà i servizi dal contenitore. Questo parametro può essere NULL.

[in] pStg

Puntatore all'interfaccia IStorage nell'oggetto di archiviazione. Questo parametro non può essere NULL.

[out] ppvObj

Indirizzo della variabile puntatore che riceve il puntatore dell'interfaccia richiesto in riid. Al termine della restituzione, *ppvObj contiene il puntatore dell'interfaccia richiesto nell'oggetto appena creato.

Valore restituito

Questa funzione restituisce S_OK in caso di esito positivo. Altri valori possibili includono quanto segue.

Commenti

La funzione OleCreateFromFile crea un nuovo oggetto incorporato dal contenuto di un file denominato. Se progID nel database di registrazione contiene la chiave PackageOnFileDrop, crea un pacchetto. In caso contrario, la funzione chiama la funzione GetClassFile per ottenere il CLSID associato al parametro lpszFileName e quindi crea un oggetto ole 2 incorporato associato a tale CLSID. Il parametro rclsid di OleCreateFromFile verrà sempre ignorato e deve essere impostato su CLSID_NULL.

Come per altre funzioni OleCreateXxx, l'oggetto appena creato non viene visualizzato all'utente per la modifica, che richiede un'operazione DoVerb . Viene usato per implementare operazioni di inserimento dei file.

Requisiti

Vedi anche

GetClassFile