Funzione OleQueryCreateFromData (ole2.h)

  • Articolo

Verifica se un oggetto dati ha uno dei formati che consentono di diventare un oggetto incorporato tramite una chiamata alla funzione OleCreateFromData o OleCreateStaticFromData.

Sintassi

HRESULT OleQueryCreateFromData(
  [in] LPDATAOBJECT pSrcDataObject
);

Parametri

[in] pSrcDataObject

Puntatore all'interfaccia IDataObject nell'oggetto trasferimento dati da eseguire una query.

Valore restituito

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

Codice restituito Descrizione
S_FALSE
 Non sono presenti formati che supportano la creazione di oggetti statici o incorporati.
OLE_S_STATIC
 I formati che supportano la creazione di oggetti statici sono presenti.

Commenti

Quando un'applicazione recupera un oggetto di trasferimento dati tramite una chiamata alla funzione OleGetClipboard , l'applicazione deve chiamare OleQueryCreateFromData come parte del processo di scelta per abilitare o disabilitare i comandi Modifica/Incollao Modifica/Incolla speciale . Verifica la presenza dei formati seguenti nell'oggetto dati:

  • CF_EMBEDDEDOBJECT
  • CF_EMBEDSOURCE
  • cfFileName
  • CF_METAFILEPICT
  • CF_DIB
  • CF_BITMAP
  • CF_ENHMETAFILE
Determinare che l'oggetto dati ha uno di questi formati non garantisce assolutamente che la creazione dell'oggetto avrà esito positivo, ma è destinata a aiutare il processo.

Se OleQueryCreateFromData trova una delle CF_METAFILEPICT, CF_BITMAP, CF_DIB o CF_ENHMETAFILE formati e nessuno degli altri formati, restituisce OLE_S_STATIC, indicando che è necessario chiamare la funzione OleCreateStaticFromData per creare l'oggetto incorporato.

Se OleQueryCreateFromData trova uno degli altri formati (CF_EMBEDDEDOBJECT, CF_EMBEDSOURCE o cfFileName), anche in combinazione con i formati statici, restituisce S_OK, indicando che è necessario chiamare la funzione OleCreateFromData per creare l'oggetto incorporato.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione ole2.h
Libreria Ole32.lib
DLL Ole32.dll
Set di API ext-ms-win-com-ole32-l1-1-3 (introdotta in Windows 10, versione 10.0.10240)

Vedi anche

OleCreateFromData

OleCreateStaticFromData

OleQueryLinkFromData