Metodo IOleObject::GetClipboardData (oleidl.h)

Articolo
08/25/2023

Recupera un oggetto dati contenente il contenuto corrente dell'oggetto incorporato in cui viene chiamato questo metodo. Usando il puntatore a questo oggetto dati, è possibile creare un nuovo oggetto incorporato con gli stessi dati dell'originale.

Sintassi

HRESULT GetClipboardData(
  [in]  DWORD       dwReserved,
  [out] IDataObject **ppDataObject
);

Parametri

[in] dwReserved

Questo parametro è riservato e deve essere zero.

[out] ppDataObject

Indirizzo della variabile puntatore IDataObject che riceve il puntatore dell'interfaccia all'oggetto dati. Se si verifica un errore, ppDataObject deve essere impostato su NULL. Ogni volta che un oggetto riceve una chiamata a IOleObject::GetClipboardData, deve aumentare il conteggio dei riferimenti su ppDataObject. È responsabilità del chiamante chiamare Release quando viene eseguita con ppDataObject.

Valore restituito

Questo metodo restituisce S_OK se l'operazione ha esito positivo. Gli altri valori restituiti possibili includono i seguenti:

Codice restituito	Descrizione
E_NOTIMPL	GetClipboardData non è supportato.
OLE_E_NOTRUNNING	L'oggetto non è in esecuzione.

Commenti

È possibile usare il metodo IOleObject::GetClipboardData per convertire un oggetto collegato in un oggetto incorporato, in cui l'applicazione contenitore chiamerebbe IOleObject::GetClipboardData e quindi passare i dati ricevuti a OleCreateFromData. Questo metodo restituisce un puntatore a un oggetto dati identico a quello che sarebbe stato passato agli Appunti da un'operazione di copia standard.

Note ai chiamanti

Se si vuole uno snapshot stabile del contenuto corrente di un oggetto incorporato, chiamare IOleObject::GetClipboardData. Se si modificano i dati, sarà necessario chiamare di nuovo la funzione per uno snapshot aggiornato. Se si vuole che il chiamante venga informato delle modifiche apportate ai dati, chiamare QueryInterface, chiamare IDataObject::D Advise.

Note per gli implementatori

Se si implementa questa funzione, è necessario restituire un puntatore IDataObject per un oggetto i cui dati non verranno modificati.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	oleidl.h